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ORGANIZATION 



PDP-10 software can be generally divided into eight functional groupings with respect to 
common programming activities. These are: 

1 • Source Program Preparation; 

2. Conversational Language Translators; 

3. Program Loading and Library Facilities; 

4. Debugging; 

5. Utilities; 

6. Calculators; 

7. Batch Processing; and 

8. Monitoring. 

This Guide is arranged according to the above order. 
Source Progra m Preparation (EDITOR^ TECO) 

The DECtape Editor and the Text Editor and Corrector (TECO) programs can be used to create (and later 
correct or modify) text files (e.g., Macro-10 and FORTRAN source language programs) for subsequent 
assembly or compilation. Editor creates and modifies files on DECtape; TECO performs more complex 
editing functions on any standard I/O devices. 

Conversational Language Translators (MACRO, F40) 

The Macro-10 Assembler (MACRO) and the FORTRAN Compiler (F40) translate source programs written 
in the Macro-10 and FORTRAN IV languages, respectively, into binary machine language for subsequent 
loading and execution. 

Program Loading and Library Facilities (LOADER, LIB40, JOBDAT, FUDGE2) 

Loading is performed by the Linking Loader, which takes specified relocatable binary programs, loads 
them in core, links their references to each other, and searches the appropriate subroutine libraries 
(e.g., LIB40) for required subroutines. A job data area (JOBDAT) is created by the Loader for each 
program; this area is used to store the current status of the job during execution. Library files of binary 
programs can be updated when desired by use of the File Update Generator (FUDGE2). 
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Debugging (DDT, CREF, GLOB) 



Once a program is compiled (or assembled), it can be loaded along with the Dynamic Debugging Tech- 
nique (DDT) program and debugged. DDT allows the user to control program execution and to modify 
his program in any of several modes, including symbolic. For purposes of further program analysis (and 
for documentation), the user can elect to use the Cross Reference Listing (CREF) program, which produces 
a cross-referenced listing of all symbols within his Macro program, and the Global Cross- Reference 
Listing (GLOB) program, which produces one to three helpful listings of all global symbols encountered 
in one or more programs. 

Utilities (PIP, CONVRT, CODE, SRCCOM, BINCOM) 

Digital provides a variety of utility programs for general purpose data handling. Among these programs 
are: the Peripheral Interchange Program (PIP), which transfers data between any standard I/O devices; 
DECtape Format Converter (CONVRT), which converts DECtapes from the old PDP-6 format to the new 
PDP-10 format (or vice versa); Code Translator (CODE), which performs translations between standard 
ASCII codes and code of other manufacturers; Source Compare (SRCCOM), which compares two versions 
of an ASCII file; and Binary Compare (BINCOM), which compares two versions of a binary file. 

Calculators (AID, DESK) 

Two easy-to-use problem solving calculators for scientists and engineers are Included as part of the 
PDP-10 software: the Algebraic Interpretive Dialogue (AID), a problem solving calculator which is 
based upon the famous RAND JOSS'algebraic language; and Desk Calculator (DESK), which provides 
immediate access to common arithmetic subroutines. 



Batch Processing (BATCH, STACK) 

The Batch Processor (BATCH) supervises the sequential execution of a series of user jobs with a minimum 
of operator attention, operates as one of the "users" in a time-sharing environment and runs concurrently 
with the Batch-controlled jobs (as well as other jobs on the system), and permits constant communication by 
the operator. Job Stacker (STACK) prepares input stacks for BATCH and processes output stocks from BATCH 

Monitors 

PDP-10 software includes five separate Monitors, ranging from the single-user 10/10 Monitor, designed 
for an 8K paper tape system, to the swapping time-sharing 10/50 Monitor, designed for the 32K (and 
larger) disk systems. In between these are the single-user 10/20 Monitor for an 8K DECtape system, the 
single-user 10/30 Monitor for larger systems, and the time-sharing 10/40 Monitor for 16K (and larger) 
multiprogramming systems. System Builder (BUILD) is used to construct a Monitor specifically designed 
for the user's machine configuration and other requirements. 



JOSS is the trademark and service mark of the RAND Corporation for its computer program and services 
using that program. 
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SYSTEM OPERATION 



Communication with the Monitor and loading and executing Digital-supplied Common User Service 
Programs (CUSP's), as well as your own programs, is a simple matter once you become familiar with a 
few basic rules. 

To establish communication with the Monitor, you place your Teletype in Monitor mode by entering the 
Monitor command mode> Generally, this is accomplished by typing ♦C (i.e., by holding down the 
CTRL key while striking "C"). Monitor responds with a period (.) and you can then direct Monitor to 
load and start a program from the System Library (.RUN prog), start a program already loaded in core 
(.START), discontinue your job (.KJOB), and many other operations. 

All cusp's supplied by Digital are device independent . Because of this, you must tell the CUSP, via 
a command string typein, which devices to use. Readiness to receive a command string is signalled by 
the CUSP via an asterisk (*) typeout after loading. For example, when you have called in the FORTRAN 
IV Compiler and it has responded with an asterisk, you would type in a command string indicating (1) 
the device containing the source program to be compiled, (2) the device on which the binary output is 
to be placed, and (3) the device on which the compilation listing is to be written: 

* binary-output-device, listing-devices— source-device 
Devices are specified by a 3-character device name (a fourth character, a digit, specifies the particular 
unit in the case of DECtapJps and magnetic tapes) followed by a colon. 



Card reader CDR: 

Line printer LPT: 

Paper tape reader PTR: 

Paper tape punch PTP: 

Teletype TTY: 

DECtape DTAn: 

Magnetic tape MTAn: 

Disk DSK: 



For file-oriented devices (DECtape and disk), a filename is also required following the device name to 
specify either the specific file to be read or the filename to be assigned to the output* A filename can 
consist of a maximum of six characters. A filename can be further specialized by adding a 3-character 
extension name to it, preceded by a period (.). Extension names are generally used to classify a file 
into a particular category and certain standard extensions are used and recognized throughout the system 
(e.g., .REL for relocatable binary files, .DMP for saved core image files, etc.). A sample FORTRAN 
command string might appear as follows. 
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DTA1:BIN.REL,LPT:<1 DTAOrSOURCE Compile the file called "SOURCE" on 

DECtape 0; write the binary output on 
DECtape 1, calling it "BIN.REL"; print 
the listing on the line printer. 
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COLOR CODE CONVENTIONS 



1 



All computer typeouts are printed in dark blue. 
All operator typeins are printed in black. 

All commentary is printed in light blue. 



SYMBOLOGY USED IN CONSOLE EXAMPLES 



Hold down the CTRL (control) key while striking "C." Normally echoes as ^C. 

Hold down the CTRL (control) key while striking the "x" key, where "x" is any 
character . Norma I ly echoes as ^ x . 

Some special control symbols and their respective key designations for Models 33 and 
35 Teletypes are given below. 



Key Designation 

(tape) 



^S^Pg ) (not-TAPE) 

(belD 

(TAB) (horizontal) 



(JD (vertical tab) 



(XON) 
(XOFF) 



2: 

(ALTMODE) 
or(D 

[ 
] 



Shown in This 
Manual as: 

^T 
— t>j or^I 



Method of Entry 



1 



/ whi le striking "R . " 



Hold down C"' V 
Hold down C 
Hold down C "G." 
Hold down CTRL key wh "L'' 
Hold down CTRL key U/^ 
Hold down CTRL mg 

(Initialize paper tape re- ut,) Hold 

down CTRL key while srr 3", 

(Terminate paper tape reader input.) Hold 
down CTRL key while striking "S"* 



Hold down the SHIFT key while striking '^O." 

Strike the RETURN key , Normally echoes bock as a carriage return , line feed. 
Strike the ALTMODE key (sometimes labelled "ESC" or "PREFIX"). 

Unless a " [" key is present on the keyboard, hold down the SHIFT key while 
striking "K 

Unless a "] "key is present on the keyboard, hold down the SHIFT key while 

striking "M , " 



"Method of Entry" is for Models 33 and 35Teletypes primarily. On the Model 37 Teletype, many of 
the special symbols appear on the keyboard and are easily entered. 
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^ When oppearing alone (as in DDT). Hold down the SHIFT key while striking ''N,'^ 

Hold dov/n the SHIFT key while striking • - 

Hold down the SHIFT key while striking . " . 
(LINE-FEED) Strike the LINE-FEED key. 

CRUBOUT) Strike the RUBOUT"^key, Normally echoes back as a backslash (\)^ XXX^ or a repeat 

of the character erased » 

\ or (FORM) Unless a \ key is present on the keyboard, hold down the SHIFT key while 
shTking^^." 

I— I Strike the space bar to space to indicated position, TAB can also be used in most 

instances . 



On the Model 37 Teletype, this key is labeled DELETE. 
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DEMONSTRATION 



The following example is designed to demonstrate the ease of operation and flexibility of a PDP-10 soft- 
ware system. Basically, this particular sequence involves the compilation of a FORTRAN source program, 
the assembly of a Macro-10 subprogram written in conjunction with the FORTRAN program, the loading 
and linking of the two resultant machine language programs, their execution and correction under control 
of the Dynamic Debugging Technique (DDT) program, correction of the original source coding, and a 
final rerun of the corrected programs. Several errors have been purposely introduced in the source coding 
to demonstrate the ease with which testing, debugging, and updating of programs is accomplished. The 
procedure for detaching from the current job, logging in and beginning a second job, and then returning 
to the original job is also illustrated. 
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FLOW CHART 



0 
© 

© 

© 



USER LOGS IN H I S 
IDENTIFJCATION TO 
MONITOR AND I S 
ASSIGNED A JOB 
NUMBER 



FO RTR AN m 
COMPtLATI ON 
(SOURCE STATEMENTS 
ARE INPUT FROM THE 
CARD READER) 



GENERATION OF MACRO 
SOURCE SUBPROGRAM ON 

DECTAPE V I A TEXT 
EDITOR AND CORRECTOR 
{TECO)PROGRAM 



MACRO-10 ASSEMBLY OF 
SUBPROGRAM 



DETACH FROM JOB 1 



USER LOGS IN 
AS JOB 2 



START CROSS REFERENCE 
L I ST ING ON LINE 
PRINTER VIA CREF 



ATTACH TO JOB 



CREF CONTINUES AS 
USER RETURNS TO JOB 1 



ERRORS DETECTED IN SOURCE CODING 



CORRECT MACRO SOURCE 
SUBPROGRAM VIA TECO 



© 



© 



TRANSFER MACRO 
ASSEMBLER BINARY OUTPUT 
FROM DISK TO DECTAPE 
CONTAINING FORTRAN 
OUTPUT 



REASSEMBLE CORRECTED 

SOURCE SUBPROGRAM; 
BINARY OUTPUT WRITTEN 
ON DISK 



© 



LOAD DYNAMIC 
DEBUGGING TECHNIQUE 

(DDT), FORTRAN AND 
MACRO BINARY OUTPUT 
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® 



EXECUTE FORTRAN IV 
PROGRAM AND MACRO 
SUBPROGRAM (WITHOUT 
DDT) 


ERRONEOUS OUTPUT ® 
» 


DEBUG. CORRECT. AND 
EXECUTE (ALL PERFORMED 
UNDER DDT) 











SAVE CORRECTED 
PROGRAM ON DECTAPE 



LIST DECTAPE DIRECTORY 

(VIA PERIPHERAL 
INTERCHANGE PROGRAM) 



UPDATE MACRO SOURCE 
SUBPROGRAM VIA TECO 
BY CORRECTING ERRORS 
FOUND DURING DDT 
EXECUTION 



RERUN SAVE 


:0 PROGRAM 







TERMINATE JOB 1 



I 

ATTACH TO JOB 2 



TERMINATE JOB 2 
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CONSOLE OPERATION 



(7^ .LOGIN^ 



JOB 1 DEC3.16Ky 
12,4/ 

0426 1-27-68 



The user begins by identifying himself to the system . 
Monitor assigns the user a Job number (JOB I) and 
types the version of the Monitor currently in use 
(DEC 3.16K), User then responds by typing his 
project-programmer number (12,4) and his password 
(typed over a mask generated by Monitor) ♦ Monitor 
indicates acceptance of number and password by 
responding with the current time and date and • 



(?) .ASSIGN LPV 
LPT ASSIGNED^ 
.ASSIGN CDRJ 
CDR ASSIGNED^ 
.ASSIGN DTA DT^ 
DTAO ASSIGNED^ 



User assigns the line printer (LPT) and the card reader 
(CDR) to his job (both are nonsharable devices) . He 
also requests that on available DECtope also be as- 
signed and given the logical name " DT" . Monitor 
responds by assigning an available DECtape, DTAO, 
to the job . At this point, the user mounts his DEC- 
tope on DECtape unit 0, places his FORTRAN source 
program deck in the card reader, and checks that 
both the card reader and printer are in a ready status . 

NOTE: If the user is operating from a remote Tele- 
type, he can transmit appropriate instruc- 
tions to the console operator's Teletype via 
the Monitor TALK command , 



. R F40^ Directs the Monitor to load and execute the FOR- 

TRAN IV compiler, 

*DT:ARRIVE, LPT: <— CDR:^ The compiler responds with on asterisk when loaded . 

At this point, the user instructs the compiler to (1) 
read the source program deck from the card reader 

MAIN. ERRORS DETECTED: Od (<3 — CDR:); (2) place the binary output on his DECtape 

TOTAL ERRORS DETECTED: 0^ and assign it a filename of "ARRIVE" (DT:ARRIVE); 

9K CORE USED^ and (3) print the compilation listing on the line 

printer (LPT:). 

NOTE: A listing of the FORTRAN source program 
deck is presented in Figure DEMO~l . 

The compiler completes the compilation and types the 
number of errors detected and amount of core used and 
an * to indicate it is ready to do another compilation* 
Since the user has no further compilations at this 
time, he returns to the Monitor command level ( ^C). 

NOTE: The FORTRAN compilation listing is shown 
in Figure DEMO-2. 
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The user releases the line printer and the card reader 
so that other time-sharing users can have access to 
them . 

The user now directs the Monitor to load TECO, which 
he will use to generate a Macro source program 
directly from his Teletype onto his DECtape so that it 
will be available for future modification and re- 
assembly . 

TECO responds with an when loaded. The user 
directs TECO to insert (I) into its output buffer the 
text which follows the "I" in its command buffer 
area. For buffer use efficiency, the text is entered 
in segments; each segment is terminated by two 
ALTMODE'S ((DQ), the first delimiting the inser- 
tion and the second causing TECO to execute the 
command string (i.e., transfer the contents of the 
command buffer into TECO's output buffer), clear the 
command buffer, and respond with an . Each seg- 
ment begins with a new insert command. For those 
users incapable of the error-free typing shown in this 
example, TECO's features include the ability to wipe 
out one or more characters (by striking the RUBOUT 
key once for each of the previously typed characters 
to be erased) and the ability to wipe out the preced- 
ing line of characters (by typing OLK, followed by a 
new \nserf command to enter the \n\ended line). 

MTITLE RANDOM NUMBER GENERATING SUBROUTINE^ 
SUBTTL CHARLIE PROGRAMMER 27 JAN 1968^ 

;RANDOM NUMBER GENERATING SUBROUTINE^ 

''I;THE FORTRAN CALLING SEQUENCE IS — ^ 

CALL RANDOM(ARG)^ 
; WHERE ARG SPECIFIES THE LOCATION AT WHICH THE RESULTING^ 
; SINGLE PRECISION FLOATING POINT RANDOM NUMBER WILL BE^ 
; STORED. NUMBERS PRODUCED BY THIS ROUTINE ARE "PSEUDOV 
; RANDOM NUMBERS" BUT ARE UNIFORMLY DISTRIBUTED OVER[o, l].^ 

INTERNAL RANDOM^ 

ACX=5 ;ACCUMULATOR^ 

ACY=6 ; SYMBOLIC/^ 

ACZ=ACY+1 ; DEFINITIONS.^ 



. DEASSIGN LPT^ 
. DEASSIGN CDR^ 

(7) .RTECO^ 
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*IRANDOM: 0 

CALL 



;ENTERED BY JSA 16, RANDOM^ 
ACX, [sIXBIT/TIMER] ;GET TIME IN CLOCK TICKS.^ 



ANDI ACX,3 



*IRLOOP: 



*I 



MOVE 
MUL 
MOVEM 
SOJGE 

LSH 

TLO 

FADRI 

MOVEM 

JRA 



ACY,RNUMBR 
ACY, MAGIC 
ACZ,RNUMBR 
ACX,RLOOP 

ACZ,-^D8 
AC Z, 20000 
ACZ,0 

ACZ/a)(16) 
16,1 (16) 



;USE TIME TO SELECT 1-4 ITERATIONS.^ 

FETCH PREVIOUS PSEUDO-RANDOM NUMBER. 
MULTIPLICATIVE RANDOM NUMBER GENERATOR.^ 
SAVE NEXT PSEUDO-RANDOM NUMBER.^ 
ITERATE AGAIN ?^ 

CONVERT TO FLOATING POINT FORMAT^ 

IN THE RANGE[o, l] .J 
NORMALIZE.^ 
STORE RESULT, AND - 
***RETURN.***^ 



d 

*I;THE MULTIPLIER USED IN THIS PSEUDO-RANDOM NUMBER GENERATOR IS 5 RAISED^ 
; TO THE 15TH POWER (SEE COMPUTER REVIEWS VOL. 6, NO. 3, REVIEW NUMBER^ 
; 7725, AND THE REFERENCED PAPER IN JACM JAN'65 PP83-89).^ 

MAGIC: 5*5*5*5*5*5*5*5*5*5*5*5*5*5*5 ;THE MULTIPLIER 

RNUMBR: 1 ;THE NEXT RANDOM NUMBER IS ALWAYS HERE^ 

;(THE ITERATION STARTS FROM A VALUE OF 1).^ 

PATCH: BLOCK 10 ;PATCHING SPACE. ^ 



END^ 



*HT^ 

TITLE RANDOM NUMBER GENERATING 
SUBTTL CHARLIE PROGRAMMER ....^ 
etc. 

PATCH: BLOCK 10 
END^ 



The command "HT" followed by two ALTMODE'S 
(d) (D) directs TECO to type out the entire contents 
of the output buffer. 



;PATCHING 
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*BJSNTERNAL (D-7CIl(D-L2Tt^ 

INTERNAL RANDOM^ 
*SPP83 (D-2CI (DOLT(D(D^ 



.The user notices that he has made two typing errors: 
(1) an "1" is missing from "NTERNAL" (the "1" al- 
ready there is the insert command); and (2) a space is 
misssing between "PP" and "83" in his comments line. 

Search for "NTERNAL"; insert an "I" in front of it, 
and type out the corrected line. For details of this 
fairly complex command, see the section entitled 
"TECO". 



Search for "PP83", insert a space between the "PP" 
and "83", and type out the corrected line. 
7725, AND THE REFERENCED PAPER IN JACM JAN '65 PP 83-89.^ 

Sotisified that his source coding is correct, the user 
directs TECO to write out the contents of the output 
buffer on his DECtape and assign it the filename 
"RAN DOM. MAC". 



* EW DT :RAN DOM . MAC (D P WE F (D (D ^ 

(T) .R MACROf/ 

*DSK:BIN, /C <— DT:RANDOM.MACji 



A 000001/040240 000026' CALL 
;GET TIME IN CLOCK TICKS.^ 



THERE IS 1 ERRORS 
PROGRAM BREAK IS 000027^ 
5K CORE USED^ 

.DETACH^ 

.LOGINJ 

JOB 2 DEC 3.16K^ 

12, 4^ 

0458 1-27-68 j 
^C^ 



Having finished with TECO, the user returns to the 
Monitor command level . 

The user directs Monitor to load the Macro~10 As- 
sembler . 

Macro-! 0 responds with an * when loaded. The user 
directs Macro-10 to assemble the source program file, 
RANDOM. MAC, located on DTAO. The binary out- 
put is to be written on disk under the filename "BIN" . 
A modified assembly listing is written on the disk 
(assumed device) with /C switch and assigns it the file- 
name CREF JMP, 

acx,[sixbit/timer] 

A source language error has been encountered in the 
input. 



User returns to the Monitor command level . 

User detaches console from this job without affecting 
the status of the job. He is now free to initiate a 

new job* 

Monitor responds as before with user logged in as 

job 2 now. 
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.RCREF^ 

'i 



.CCONT^ 

.ATTACH 1, (12, 4)^ 



User calls CREF to get the cross-reference assembly 
listing. CREF selects default assumptions of: 
output - dev: LPT: 
input - dev: DSK: 
filename - ext CREF.TMP 

The LPT is ovailable . The user does not assign it so 
that it will be available to other users when his 
listing is completed. 

User interrupts CREF in progress and returns control 
to the Monitor. 

User allows the job to continue running and leave 
the console in Monitor mode , 



© 



Automatically detaches the console from the current 
job and attaches it to job 1 belonging to 12,4 which 
was the previous user job, 

.R TECO^ 

He directs Monitor to load TECO again . 
*ERDT:RANDOM.MAC$YBJS/TIMER ® l/(D OLT ® (D^ 
CALL ACX, [SIXBITAIMER/];....J 



^EWDT:RANDOM.MAC(DpWEF(D(D 



He directs TECO to read its input from filename 
RANDOM, MAC, search for "/TIMER", insert a 
after it, and type out the corrected line. 

He directs T ECO to write the corrected file over the 

old file on his DECtape by giving it the some filename . 

He then returns to the Monitor command level to call 
Macro-] 0 back in and reassemble , 



(T).R MACRO (J 

*DSK:BIN,LPT:< 



■DT:RANDOM.MAC^ 



THERE ARE NO ERRORS^} 
PROGRAM BREAK IS 000027^ 
5K CORE USED^ 

^tc^ 



(7).RPIP^ 



^DT:RAN.REL<— DSK:BIN.REL^ 



The user reloads Macro-! 0, using the same commands 
as before. The prev ious contents of the file BIN on 
the disk are overwritten with the binary output pro- 
duced by this assembly. 

NOTE: The assembly listing is shown in Figure 

DEMO-3. 

The user now decides that he would like to transfer 
the binary output file just produced from the disk to 
his DECtape so that it wil I be together with the other 
program files of this job. 



To do this, he directs Monitor to load the Peripheral 
Interchange Program (PIP), 

PIP responds with an * when loaded . The user directs 
PIP to transfer the file BIN ,REL from the disk to his 
DECtape and call it RAN.REL. 
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PIP accomplishes the requested transfer and responds 
with another asterisk indicating readiness for a new 
command. 

He returns to the Monitor command level to call 
Linking Loader. 

He directs Monitor to bring in Linking Loader and 
assigns it 7K of core. 

He directs Linking Loader to load DDT (/D) from the 
SYS device and the two binary programs, RAN and 
ARRIVE, from his DECtape. Linking Loader auto- 
matically searches for files with an .ext of .REL (both 
the FORTRAN compiler and Macro Assembler create 
binary output files with this .ext assumed). 

Loading is completed. Linking Loader returns the user 
to the Monitor command level. 



The user directs Monitor to begin execution of the 
loaded programs at the starting address of the last 
loaded program (i.e., the FORTRAN program, 
"ARRIVE"). 

RANDOM INTER-ARRIVAL TIME GENERATOR. . 

TYPE MEAN WAITING TIME PLEASE: 100.0(i 

NOW TYPE NUMBER OF SAMPLE TIMES DESIRED:! 0^ 

I he user*s program is now in control and prints instruc- 
tions for entering parameters . 

The user decides to try a mean waiting time of 100 and 
asks for 10 sample random times. 

T= 0. 77751 067E+0V 
T= 0.78527278E+04^ 
T= 0.78476048E+04// 
T= 0.78677823E+04/^ 
T= 0.781 031 87E+04/^ 
T = 0.77700529E+042^ 
T = 0.77733533E+04// 
T = 0.77725470E+04t/ 
T = 0.80251 91 9E+04^ 
T= 0.77787954E+04^ 

TYPE MEAN WAITING TIME PLEASEr^C^ Since the program has obviously produced incorrect 

results (the output is far from random and conspicu- 
ously in the wrong range), the user returns to the 
Monitor command level. 
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(T) .R LOADER 7^ 

*/D DT:RAN, ARRIVE (ALTMOPQ ^ 



LOADER 1^ 
EXIT^ 

(T).STARV 



(l0).DDT^ 



The user calls DDT to aid him in his debugging. 

&n A K\r^r^L A& 1 Althouqh DDT is often used to dynamically obtain 

$RANDOM$:J , , ,111 r» /i « 

intermediate results and help the user tmd his errors^ 

RLOOP+5/piTLO ACZ,20000-{>|TLO AC Z, 200000^ it is assumed for the purposes of this example that he 

has discovered his error by iooking at his assembly 

listing. He then uses DDT to correct locotion 

RLOOP-^'S (he hod omitted a zero In his source coding). 

Note that DDT permits symbolic typeouts and cor-- 
rections* 

MAIN.$:^ 

1 2P+1 1 $T/ ED: ' $ "/ED: / (LINE FEED) J He also discovers that his FORTRAN program failed to 

12FM-12/ ) "/ '%)/ iJ space following the second request for input (NOW 

TYPE NUMBER. . . ,). Therefore, he also modifies lo- 
cations 12P+11 and 12P+12 in his FORTRAN program. 
For details concerning DDT commands and responses, 
see "DDT." He then directs DDT to begin execution 
of his programs , 

RANDOM INTER-ARRIVAL TIME GENERATOR FOR POISSON PROCESSES 

TYPE MEAN WAITING TIME PLEASE: 100.0 ^ 

NOW TYPE NUMBER OF SAMPLE TIMES DESIRED: 10^ 



T = 0.13360079E+03^ 
T = 0.83559460E+01^ 
T = 0.48267604E+03^ 
T = 0.12974962E+00^ 
T = 0.1 2997161 E+03J 
T= 0.10218452E+03ti 
T = 0.1 8005033 E+03(i 
T = 0.204551 30 E+02ti 
T = 0.40742972E+02^ 
T = 0.39184699E+01^ 

TYPE MEAN WAITING TIME PLEASE:^C ^ Results appear to be correct this time. The user re- 

turns to the Monitor command level. 



(T?) - SAVE DT: ARRIVE 7^ 



JOB SAVED^ 



The user directs Monitor to save the core image of 
his corrected program on his DECtape, calling the 
saved file ARRIVE (the file extension . SAV is auto- 
matically appended) He specifies that 7K of core is 
to be used any time this program is run. After the 
image file has been written. Monitor automatically 
returns to the command level. 
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.R PIP^ 
*TTY:* 
426 



<— DT:/L ^ 
FREE BLOCKS LEFT ^ 



ARRIVE. REL 
RANDOM. MAC 
RAN. REL 
ARRIVE. SAV 



27-JAN-68ii 
27-JAN-68ci 
27-JAN-68ti 
27-JAN-68ti 



The user now calls PIP and asks for a listing of his 
DECfape direcfory on his Teletype. In this way, he 
verifies that all of the files which should be on the 
tape are actually there. 

PIP lists the number of free blocks left and the name 
and creation date of each file. 



(l3)^^Cii 

.R TECOji 

*ERDT:RANDOM.AAAC(|)YBJS20000®I0(l)0LT(l)ti 



The user returns to Monitor command mode and 
calls TECO. He updates his Macro source pro- 
gram (RAN DOM. MAC) to reflect the correction 
made to the binary program via DDT, and has 
TECO type the corrected line (see ^'TECO^'for 
details of command string). 



TLO ACZ, 200000 ; IN THE RANGE[0,1].^ 

'EWDT:RANDOM.MAC(DPWEF(|XDfi corrected file is written over the old 

the DECtope. 



® 



14) .RUN DT:ARRIVE(i 



As a final proof that his program now works, he reruns 
the saved version . 



RANDOM INTER-ARRIVAL TIME GENERATOR FOR POISSON PROCESSES ^ 
TYPE MEAN WAITING TIME PLEASE: 50E+]^ 
NOW TYPE NUMBER OF SAMPLE TIMES DESIRED: 



T = 0.57171 754E+03 ^ 
T = 0.90873993E+03 |i 
T = 0. 4926401 3 E+03tt 
T = 0. 22028286 E+03^ 

TYPE MEAN WAITING TIME PLEASE: ^ C^ 



(Ts) .KJOB^ 
26.47^ 
26.47^ 



Having finished his work, the user terminates his job 
(KJOB). This releases his job number (and any 
ASSIGNed devices) to the Monitor pool . Monitor 
responds by typing the number of seconds of computer 
time used for the entire job and the number of sec- 
onds since he last asked for this information (via a 
TIME command) ♦ The user is now logged off the 
machine and the Teletype is in detached mode. 



(t7) .attach 2 [l2, 4] ^ 

®.KJOB^ 
r\r\ nr\ 



00.30 
00.30 



Attach to job which had been running CREF. 



Kills job and releases devices. 
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c 


SAMPLE PROGRAM — CHARLIE PROGRAMMER 1/ JAN lYoo 


c 
c 


THIS PROGRAM GENERATES RANDOM INTER-ARRIVAL TIMES FOR 


c 


A "POISSON PROCESS" WITH ANY DESIRED MEAN INTER-ARRIVAL 


c 


TIME. (THE INTER-ARRIVAL TIMES FOR POISSON PROCESSES 


c 


ARE THEORETICALLY KNOWN TO HAVE AN EXPONENTIAL 


c 


PROBABILITY DISTRIBUTION.) 


c 


TYPE 9 


c 


FIRST ACCEPT THE MEAN INTER- ARRIVAL TIME FROM THE 


c 


USER (VIA HIS TELETYPE CONSOLE). 


6 


TYPE 10 




ACCEPT 11 ,TMEAN 


c 


NEXT LET THE USER SIMILARLY SPECIFY THE NUMBER OF 


c 


RANDOM SAMPLES HE WANTS PRODUCED. 




TYPE 12 




ACCEPT 13,N 


c 


ITERATE AS MANY TIMES AS REQUESTED — 




DO 7 I-l , N 


c 


USE MACROX-CODED SUBROUTINE TO PRODUCE A UNIFORMLY 


c 


DISTRIBUTED RANDOM VARIABLE, R, IN THE RANGE C0,1] . 




CALL RANDOM(R) 


c 


TRANSFORM TO AN EXPONENTIALLY DISTRIBUTED RANDOM VARIABLE. 




T = -TMEAN*ALOG(R) 


c 


TYPE OUT RESULTING INTER-ARRIVAL TIME — 


7 


TYPE 14,T 


c 


LET THE USER REPEAT ENTIRE PROGRAM WITH NEW VALUES. 




GU TU 6 


o 
V 


C/^DA/AT/' DAKIfN^^Ail TKITCD ADDT\/AI TTKAC ^CKICDAT/^D 

rUKMAU KANUvJM IN 1 CK-AKKIVAL llMb vjtNEKAIvJK 




1 COD DOlCCOKI DDO/^CCC CC //^ 

1 rUK rOlbbvJN rKOv-tobtb //} 


10 


FORMATC TYPE MEAN WAITING TIME PLEASE: '$) 


11 


FORMAT(E) 


12 


FORMATC NOW TYPE NUMBER OF SAMPLE TIMES DESIRED: '$) 


13 


FORMAT(I) 


14 


FORMATC T = ',E15.8) 




END 



Figure DEMO-1 FORTRAN Source Program Deck 
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ARRIVE 1/27/67 


17:18 


















C 
C 


SAMPLE CHARLIE PROGRAMMER 27 JAN 1968 










C 


THIS PROGRAM GENERATES RANDOM INTER-ARRIVAL TIMES FOR 










C 


A "POISSON PROCESS" WITH ANY DESIRED MEAN INTER-ARRIVAL 










c 


TIME. (THE INTER-ARRIVAL TIMES FOR POISSON PROCESSES 










c 


ARt THcORtTICALLY KNOWN TO HAVE AN EXPONENTIAL 










V. 


DDODADTI ITV niCTDTDI ITT(^K.I \ 

rKVJDADlLii Y L/lb IKidU HON 












TYPE 9 


1 KA 


/V\VJV tl 


c\^ OD 










P)l IT 
1 . 


m 777777 
Ul ,////// 










r 1 IN . 


















L 


rlKbl ACCEPT Tnb MEAN INTcR-ARRIVAL TIME FROM THE 










c 


USER (VIA HIS TELETYPE CONSOLE). 










6 


TYPE 10 


69 




Ul , 1 ur 










Cii IT 


01 777777 

Ul ,////// 










FIN . 


00 0 


















ACCEPT 11,TMEAN 




MOVEI 


01, IIP 










IN. 


01,777774 










DATA. 


02JMEAN 










FIN. 


00,0 
















c 


NEXT LET THE USER SIMILARLY SPECIFY THE NUMBER OF 










c 


RANDOM SAMPLES HE WANTS PRODUCED. 












TYPE 12 




/VlV_<' V CI 


Ul , 1 zr 










OI IT 


m 777777 
Ul ,////// 










FIN . 


00 0 


















ACCEPT 13,N 






Ul , 1 or 










IN . 


01 ,777774 










HAT A 


UU, IN 










FIN 


00 0 
















V- 


TTCDATC AC fcJlAK.I\/ TfkilCC AC DC/^I ICCTCr* 

lltKAIt Ab MANY llMtb Ab KbCjUtbTbD — 












\J\J 1 1- 1 , IN 




MOVEI 


lo , 1 








2N\ 


fVl W V LJVl 


1 T 
1 J , i 








3M 


BLOCK 0 




















Ubt MAL-K^JA-C^UUtU bUbKOUIlNt ICJ rKUDULt A UNlrUKMLY 










C 


DISTRIBUTED RANDOM VARIABLE, R, IN THE RANGE L0,lJ . 












CALL RANDOM(R) 




1 C A 

JbA 


1 O, KANUvJM 










AD 
AKO 


UZ , K 
















c 


IKANorUKM \KJ AN tArUNt IN 1 lALLY UlblKIoUItU KANUUM VAIRABLE . 












T — Tlil^AKt-tt-AI /n\ 

T — TMEAN ALOG(R) 




1 C A 


1 6, ALOG 










AI\V3 


UZ , K 










r/v\ri\ 


UU , j /Vlt AIN 










/Vi'kJ V IN/Vt 


nn T 

UU, 1 
















c 


T vy nc iix DCCiiiXTKi fkixm Ar>nT\/Ai xt Air* 

TYPE OUT RESULTING INTER-ARRIVAL TIME — 










7 
/ 


TVDC 1 yl T 

1 Yrt 14,1 


7P 


MOVEI 


01 14P 










Ol IT 


m 777777 
U 1 , / /// // 










DATA. 


07 T 
UZ , 1 










FIN . 


00,0 












15 N 










A n 1 A 

ALJJA 


















c 


LET THE USER REPEAT ENTIRE PROGRAM ^*V1TH NEW VALUES. 












GO TO 6 




JRST 


6? 
















9 


FORMAT { ' RANDOM INTER-ARRIVAL TIME GENERATOR 












1 FOR POISSON PROCESS'//) 


9P 


JRST 


4M 










ASCII 




(' RA 








ASCII 




NDOM 








ASCII 




INTER 







Figure DEMO-2. FORTRAN Compilation Listing 
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ASCII 




-ARRI 






ASCII 




VAL T 






ASCII 




IME G 






ASCII 




ENERA 






ASCII 




TOR F 










OR PO 


























AJV..11 




ESSES 






ASCII 




'//) 




4M 


BLOCK 0 
















10 FORMATC TYPE MEAN WAITING TIME PLEASE: '$) 


lOP 


JRST 


5M 








ASCII 




(' TY 






ASCII 




PE ME 






ASCII 




AN WA 






ASCII 




ITING 






ASCII 




TIME 






ASCII 




PLEA 






ASCII 




SE: 






ASCII 




'$) 




5M 


BLOCK 0 
















1 1 FORMAT(E) 


IIP 


JRST 


6M 








ASCII 




(E) 




6M 


BLOCK 0 
















12 FORMATC NOW TYPE NUMBER OF SAMPLE TIMES DESIRED: '$) 


12P 


JRST 


7M 








ASCII 




(' NO 






ASCII 




WTYP 






ASCII 




E NUM 






ASCII 




BER O 






ASCII 




F SAM 






ASCII 




PLE T 






ASCII 




IMES 






ASCII 




DESIR 






ASCII 




ED:'$ 






ASCII 




) 




7M 


BLOCK 0 
















13 FORMAT(I) 


13P 


JRST 


8M 








ASCII 




(I) 




8M 


BLOCK 0 
















14 FORMATC T = ',515.8) 


14P 


JRST 


9M 








ASCII 




/' T 






ASCII 




- ' P 

- , u 






ASCII 




15.8) 




9M 


BLOCK 0 
















END 




JSA 


16, EXIT 






MAIN.% 


RESET. 


00,0 








JRST 


IM 
















FORSE. 










RANDOM 










ALOG 










FLOUT. 










FLIRT. 










INTO. 










INTI. 










EXIT 










SCALARS 










TMEAN 




115 






N 




116 






I 




117 






R 




120 






T 




121 






Figure DEMO-2 (Cont.) FORTRAN CompMaHon Listing 
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RANDOM NUMBER 


GENERATING SUBROUTINE MACROX V003 17:46 27-JAN-68 PAGE 1 








TITLE RANDOM NUMBER GENERATING SUBROUTINE 








SUBTTL CHARLIE PROGRAMMER 27 JAN 1968 








;RANDOM NUMBER GENERATING SUBROUTINE 








;THE FORTRAN CALLING SEQUENCE IS - 








; CALL RANDOM(ARG) 








;WHERE ARG SPECIFIES THE LOCATION AT WHICH THE RESULTING 








;SINGLE-PRECISION FLOATING POINT RANDOM NUMBER WILL BE 








;STORED. NUMBERS PRODUCED BY THIS ROUTINE ARE "PSEUDO- 








?RANDOM NUMBERS" BUT ARE UNIFORMLY DISTRIBUTED OVER COJ] . 






INTERNAL RANDOM 






000005 


ACX=5 ;ACCUMULATOR 






000006 


ACY=6 ; SYMBOLIC 






000007 


AC2=ACY+1 ; DEFINITIONS. 




UUUUUU 


000000 RANDOM: 0 ;ENTERED BY JSA 16, RANDOM 


000001 


040240 


000026' 


CALL ACX, [SIX BIT/TIMER/] ;GET TIME IN CLOCK TICKS. 


000002 


405240 


000003 


ANDI ACX, 3 ;USE TIME TO SELECT 1-4 ITERATIONS. 


000003 




000015' RLOOP: MOVE ACY, RNUMBR ;FETCH PREVIOUS PSUEDO-RANDOM NUMBER. 


000004 




000014' 


MUL ACY, MAGIC ;MULTIPLICATIVE RANDOM NUMBER GENERATOR. 


000005 


202340 


000015' 


MOVEM ACZ, RNUMBR ;SAVE NEXT PSUEDO-RANDOM NUMBER. 


000006 


365240 


000003' 


SOJGE ACX, RLOOP ;ITERATE AGAIN ? 




242340 


777770 


LSH ACZ,-tD8 /CONVERT TO FLOATING POINT FORMAT 




OO 1 0*tU 


020000 


TLO ACZ, 20000 ; IN THE RANGE CO, 1] . 


00001 1 


145340 


000000 


FADRI ACZ,0 /NORMALIZE. 


000012 


202376 


000000 


MOVEM ACZ,@(16) ;STORE RESULT, AND — 


00001 3 


267716 


000001 


JRA 16,1(16) ; *** RETURN. *** 








THE MULTIPLIER USED IN THIS PSUEDO-RANDOM NUMBER GENERATOR IS 5 RAISED 








TO THE 15TH POWER (SEE COMPUTER REVIEWS VOL. 6, NO. 3, REVIEW NUMBER 








7725, AND THE REFERENCED PAPER IN JACM JAN'65 PP 83-89). 


000014 


343277 


244615 MAGIC: 5*5*5*5*5*5*5*5*5*5*5*5*5*5*5 ;THE MULTIPLIER. 


000015 


000000 


000001 RNUMBR: 1 ;THE NEXT RANDOM NUMBER IS ALWAYS HERE 






;(THE ITERATION STARTS FROM A VALUE OF 1). 


000016 




PATCH: BLOCK 10 ;PATCHING SPACE . 








END 


000026 


645155 


456200 




THERE ARE NO ERRORS 






PROGRAM BREAK IS 000027 






RANDOM NUMBER GENERATING SUBROUTINE MACROX V003 17:46 27-JAN-68 PAGE 2 


SYMBOL TABLE 






ACX 


000005 






ACY 


000006 






ACZ 


000007 






MAGIC 


000014' 






PATCH 


000016' 






RANDOM 


000000' 


INT 




RLOOP 


000003' 






RNUMBR 


000015' 






5K CORE USED 









Figure DEMO-3 /Vtacro-lO Assembly Listing 
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DECTAPE EDITOR (EDITOR) 



FUNCTION To create, add to, or delete from sequentially 

numbered source files recorded in lines of ASCII 
characters on a DECtapeJ 

• Provides a simple method of creating or 
modifying Macro or FORTRAN IV source 
programs 



ENVIRONMENT 



Monitor 


All 


Minimum Core 


IK 


Additional Core 


Not used. 


Equipment 
Required 


One DECtape unit for the reel containing the file(s) to be 
modified. 



Editor edits the source file; i.e., the input and output files are the same. Fresh source files have editing 
space in each physical DECtape block. If the user has more edits for a block than will fit in it, an extra 
block in the DECtape is used and appropriately linked to the preceding and following logical blocks of 
the file . 



EDITOR-1 



INITIALIZATION 



.R EDITOR^ 



Loads fhe DECtape Editor program. 



Editor is ready to receive a comrmnd. 



COMMANDS 



INITIALIZE A FILE FOR PROCESSING 
Sn^A^ 

Sn, filename, ex 
Sn, filename ,ext^ 



Sn, f i lename . ext CMTMODE) 



Select DECtape n and zero the directory » 

Select DECtape n, zero fhe directory^ and create 
a file called ft lename , ext . 

Select DECtape n and locate filename . exf for 
processing. 

Select DECtape n and add a new file called 
filename .ext. 



NOTE: All the above commands place Editor in the command mode; i.e., the next type in is assumec 

to be one of the commands aiven below. 



INSERT A LINE 
Innnnn^ 

nnnnn aaaa a^ 

nnnxx CZlTMODE) |^ 



Insert the following typed iine at line number mmnr 
of the currently open file; nnnnn con be specified 
as G fine sequence number or as a point A 
point refers to the last line typed. If the line num-^ 
ber already exists In the file, the line is replaced . 



INSERT MULTIPLE LINES 
Innnnn, increment^ 
nnnnn aaaa. . .aaa^ 
nnnxx bbbb. . .bbb^ 
nnnxx (ALTMODE) ^ 



Insert the following typed tines^ beginning of -line 
number nnnnn of the currently open file; nnnnn can 
be specified as a line sequence number or as o point 
Each time o line is entered^ nnnnn is increased 
by the specified increment (assumed to be 00010 if 
omitted) and the result becomes the line number for 
the next insertion. Type ALTMODE after last line 
insertion . 



EDITOR-2 



DELETE A LINE 






Dnnnnn^ 


Delete line number nnnnn frc 


^'\\y open 




file; nnnf 




* 







DELETE A SERIES OF LINES 




Dmmmmm, nnnnn^ 


D -mm through nnnnn ^' ■ 


*• 





PRINT A LINE 










Pnnnnn^ 


r 

c 


\ 






nnnnn aaa . . .aaa^ 



















PRINT A SERIES OF LINES 

Pmmmmm, nnnnn ^ P- -^m through nnnnn of the currently 

O;: 

mmmmm aaa. . .aaaji 



nnnnn bbb. . . 



CLOSE THE CURRENT FILE 








Closes the curve- 


fiie. Another file con be 


opened on the sa 


different DECtape via an 


■k 


Sn command^ or a 


return con be made to Monitor 




fo terminate Edit 
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EXAMPLES 



.R EDITOR^ 



*S1 .VECTOR (ALTMODE) 



*I20,20^ 



00020 DEFINE VMAG(A,b0 
00040 < MOVE 0,A/J 
00060 FMPO^ 
00080 MOVE 1,A+1^ 
00100 FMP 1,1^ 
00120 FAD 1^ 
00140 MOVE l,A+2^ 
00160 FMP 1,1^ 
00180 FAD 1^ 
00200 JSR FSQRT^ 
00220 MOVEMB ^ 
00240 (ALTMODO j 



*I20^ 

00020 DEFINE VMAG(A,B,C)^ 
*ILR*^ 



*I90J 

00090 MOVE 1,C^ 
*ILS*^ 



Select DECtape 1 and create a new file on it called 
VECTOR. 

Begin inserting at line sequence number 20 and in- 
crement this number by 20 each time a line is in- 
serted . Switch to text mode. 

Editor responds with first line sequence number. 
Operator types line of coding to be inserted, fol- 
lowed by a carriage return. 



Typing ALTMODE terminates insertions and returns 
Editor to command mode. 

Change line number 00020. 



*1LR''* indicates that the indexing increment has re- 
sulted in the next line number being equal to that 
of an already existing line (00040). Note that the 
indexing increment remains as 20 until explicitly 
c hanged . 

Insert a line between lines 00080 and OOiOO. 



*ILS* indicates that the indexing increment has re- 
sulted in an existing line (001 00) being skipped, 
since the next line addressed would be 001 10. 



"DISO^ 



Delete line 00180. 



EDITOR -4 



*P20,220^ 



Prinf lines 00020 through 00220. 



00020 DEFINE VMAG(A,B,C) 

00040 < MOVE 0,A^ ' 

00060 FMP 0^ 

00080 MOVE 1,A+1^ 

00090 MOVE 1,C^ 

00100 FMP 1,1^ 

00120 FAD 1^ 

00140 MOVE l,A+2^ 

00160 FMP 1,1^ 

00200 JSR FSQRT^ 

00220 MCVEM 

. KJOB^ 



Close the currently open file. 
Return to the Monitor. 

Kill the Job, deassign the DECtape, and release 
core. 
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DIAGNOSTIC MESSAGES 



Table EDITOR-1 Editor DiagnosHc Messages 



Message 


Meaning 


?DDE* 


Device data error due to a write error or WRITE LOCK switch. Editor must be 
restarted. 


?DEC* 


DECtape directory is full. 


?FAU* 


A file name assigned fo a new file already exists on the DECtape. 


?ILC* 


Illegal command. 


*ILR* 
*ILS* 


The line sequence increment specified for the insert function will cause the 
next existing line to be either replaced (R) or skipped (S). This is a warning 
message only and does not necessarily indicate an error. 


?NCF* 


Not a current file. 


?NFO* 


A command requiring an active file has been given but no file is currently 
open . 


?NLN* 


A print (P) or delete (D) command refers to a nonexistent line. 


?UNA* 


The DECtape specified in an Sn command is assigned to another job. 
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TEXT EDITOR AND CORRECTOR (TECO) 



FUNCTION 



To edit files recorded in ASCII characters on any 
standard device. 

• Performs simple editing functions as well as 
highly sophisticated search, match, and 
substitute operations 

• Operates upon arbitrary length character 
strings under control of commands which are 
themselves character strings (and contains the 
mechanisms necessary to exploit this recursive- 
ness) 



ENVIRONMENT 



Monitor 


All 


Minimum Core 


4K 


Additional Core 


Takes advantage of any additional core available. Each IK 
additional core augments the basic 6,200+- character buffer 

by 5K additional characters.^ 


Equipment 
Required 


One input device and one output device. 



PDP-IO TECO was developed at Project MAC, Massachusetts Institute of Technology. The work of the 
following people is acknowledged: Daniel L. Murphy, Stewart Nelson, Jack Holloway, Richard Green- 
blatt. 
2 

TECO automatically requests more core to expand its buffer under any of the following situations: 

1 . An insert by way of the "1" command or "X" (Q Register) will overflow the present memory 
boundaries. 

2. The command acceptance routine needs more core. 

3. The total number of characters in the Data Buffer falls below 5000, and an input command 
from a peripheral device (other than the user console) is executed. Thus, TECO maintains a Data 
Buffer of at least 5000 characters. 

If TECO is successful at obtaining more core, the following message will be typed: 
*IOOOO<IJ$>$$ 

STORAGE CAPACITY EXCEEDED 
IK NEEDED, 5K CORE IN JOB 

If TECO is unsuccessful at obtaining the core request, the following message is typed: 
STORAGE CAPACITY EXCEEDED 
UK NEEDED, NOT AVAILABLE 
? 



TECO-1 



I INITIALIZATION | 



Loads the Text Editor and Corrector progrom, 
TECO IS ready to accept o command. 



BASIC COMMANDS 



NOTES: When typing command strings to TECO, the following points should be noted. 

(ALTMODE) - One ALTMODE is used to terminate the text within a command string, 

where applicable; two successive ALTMODE's terminate the entire com- 
mand string sequence and generate a RETURN, LINE-FEED. ALTMODE's 
type back as $'s. 

(RUBOUT) - The RUBOUT key can be used to erase the preceding typed-in character(s) 
of a command stri ng. Each character erased is echoed back on the Tele- 
type (e.g., ABD CRUBOUT) DC...). Successive RUBOUT's can be used 
to erase more than one character. 

N.B. To erase a carriage return (which generates RETURN, LINE-FEED), 
two RUBOUT's are required, one RUBOUT to erase the LINE- 
FEED and one to erase the RETURN. 

Two successive ^G*s ( (BELL) 's) can be used to wipe out the entire 
command string currently being typed. 

TECO commands In the form (where "x" is any character) can be entered by either holding 
down the CTRL key while striking the "x" key or typing up-arrow (shift N) followed by the "x" 
character. These alternatives are not true where ^x is a character within a text string (such 
as in a Search argument); in this case, the CTRL key must be used. 

A carriage return, line feed, (^) is ignored in a TECO command string as long as it does 
not appear within a particular command, such as Insert, Examples of this are given on the 
following pages. 



.R TECO^ 



TECO-2 



CPI C^T TUIF TKIPI IT nF\/Tr*F 






tKdevrTilename.exr 1 pro|.proa| \/\L \ m^Uu/ 


Selects the input device and file (if specified). 




dev: DTAn: 


(DECtape) 




PTR: 


(paper tape reader) 




DSK: 


(disk) 




MTAn: 


(magnetic tape) 




CDR: 


(card reader) 




TTYn: 


(Teletype) 




filename, ext 


(DSK: or DTAn: only) 




Qproj,prog] (DSK: 


only) 




Specified only if file is located in 




other tha 


n user's area - 



SELECT THE OUTPUT DEVICE 



EWdev:f ilencme. ext Qproj, prog] (ALTMODE) 
EZdev:filename.ext [proj,prog] (ALTMODE) 



Selects the output device and file (if specified). 

Selects the output device and file (if specified), 
and rewinds the tape (if magnetic tape) or zeros 



the directory (if DECtape). 


dev: DTAn: 


(DECtape) 


DSK: 


(disk) 


MTAn: 


(magnetic tape) 


FTP: 


(paper tape punch) 


LPT: 


(line printer) 


TTYn: 


(Teletype) 


filename, ext 


(DSK: or DTAn: only) 



EF 



[proi,prog]] (DSK: only) 

Specified only if file is located in 
other than user's area. 

Terminate output on the current output file and close 
the file without selecting a new output file. 



MAGNETIC TAPE POSITIONING 




EM 


Rewind the currently selected input magnetic tape. 


nEM 


Depending upon the value of n, perform one of the 




following operations on the currently selected input 




magnetic tope. 
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MAGNETIC TAPE POSITIONING (Cont) 








1 

n 


Operation 




1 
1 


fxBWfnd tope to toad point* 




o 


Writ6 end of filc^ 




o 


OK ip one record . 




7 


Backspace one record . 




8 


Skip to logical end of tape , 




9 


Rewind and unload tape. 




11 


Erase 3 inches of tape . 




14 


Advance tape one file* 




15 


Backspace tape one file. 


NOTE 1: Throughout TECO, all numbers in 


command strings are 


interpreted as decimal. 



INPUT COMMANDS 




Y 


Read fro 


m current input device into buffer until 




1 . 


A FORM character is read (i .e , , a ''page " has been input) ^ or 




2, 


The buffer is more than 2/3 full and one of the following is encountered 






(a) Line Feed 






(b) Form Feed 






or a point 128 characters from the end of the buffer is reached. 




NOTES: 






1 . 


The FORM character^ If read^ does not enter the buffer. 




2. 


Any data previously residing in the buffer is destroyed* 




3, 


The pointer is positioned immediately before the first character in the buffer . 




4. 


Representative buffer size for 5K TECO: 






Total buffer capacity = appr ox . 11 ^200 characters 






2/3 buffer capacity =approx, 7^460 characters 






1 line-printer page = 7^200 ' characters (120 char«/line) 






(60 lines) 7,800 ' characters (130 char*/line) 


A 


Read from the current input device and append the incoming da to to information already 




residing 


in the buffer « Terminate reading on the same conditions as in Y. 




NOTES: 






1 ; 


No previous data is destroyed* 






^he pointer is not moved . 
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OUTPUT COMMANDS 

PW Output the entire buffer to the selected output device, with a FORM character appended 

OS the last character. Do not alter the contents of the buffer or move the pointer, 

nP Equivalent to a PW command followed by a Y command (i.e., output the current contents 

of the buffer followed by a FORM character, and then read in more data from the input 
device), • 

If n is specified, repeat this operation n times. If n is omitted, it is assumed to be equal 
to M.'^ 

m,nP Output the m+1 through the nth character from, the buffer to the current output file. Do 

not append a FORM character at the end. Do not alter the contents of the buffer or 
move ("he pointer. 



EDITING COMMANDS 


Move the Pointer 


nj 


Move pointer to right of the nth buffer character and give the pointer symbol (.) the 
value of n . If n is omitted, set pointer in front of the first buffer character (same as 
OJ). 


nC 


Set the pointer to the right of the nth character beyond the pointer's present position 
(equa 1 to ,+nJ). If n is omitted , 1 is assumed . 


nR 


Set the pointer to the left of the nth character prior to the pointer's present position 
(equal to . -n J) . If n is omitted, 1 Is assumed . 


tiL 


+n - Move the pointer to the right, stopping after it has passed over n LINE-FEED 
characters . 

-n - Move the pointer to the left, stopping after it has passed over n+1 LINE-FEED ■ 
characters, then move to the right of the last LINE-FEED character passed over . 
If n is omitted, assume 1 L . 


Delete Text 




nD 


Delete n characters . 

+n - Delete them just to the right of the pointer . 

-n - Delete them just to the left of the pointer . 
If n is omitted, 1 is assumed . 


nK 


+n - Move the pointer to the right, stopping after It has passed over n LINE-FEED 
characters. Delete oil characters the pointer passes over . 

-n - Move the pointer to the left, stopping after It has passed over n-r-l LINE-FEED 

characters, then move It to the right of the last LINE-FEED character passed over , 
Delete all characters between this point and the pointer's previous position . 

If n Is omitted, 1 is assumed . 


m,nK 


Delete the m-r] through the nth characters of the buffer , Set the pointer where the 
deletion occurred . 
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EDITING COMMANDS (Cont) 


Insert Text 




ItexK . . CaLTMODE) 

Insert the text following the "I" up to, but not including, the ALTMODE character, begin- 
ning at the current pointer position. Move the pointer to the right of the inserted material . 


nl 


Insert at the pointer location a character whose ASCII code is n (n must be a decimal 
value). Move the pointer to the right of the inserted character. 




Insert at the current pointer location the ASCII text representation of the decimal value 
of the expression n. Move the pointer to the right of the inserted text . 


— D| text. . . 


Caltmode) 

Insert at the current pointer location a TAB ( ) character and the following text up 
to but not including the ALTMODE character. Move the pointer to the right of the 
inserted text. 


@ I/text/ 


Insert at the current pointer location the text which follows. The text is delimited by 
a character, /, which can be any character not appearing in the text , 


Type Text 


NOTE: T commands do not move the pointer. 




Type out the string of characters beginning at the current pointer position and terminating 
after the nth LINE-FEED character is encountered . 

+n - n lines to the right of the current pointer position, 

-n - n lines to the left of the current pointer position , 

If n is omitted, the value is assumed to be "1 . " 


m,nT 


je out the m+1 through the nth characters of the buffer. 
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I STAND-ALONE EXAMPLES (BASIC) 



Open an Input File 

a) ERDTA5:SOURCE.MAC (ALTMODE) 

b) ERDSK:SRCE.MACD2,24] (ALTMODB 

c) ERPTR: (ALTMODE) 

Open an Output File 

a) EWDTA3:EDITED.MAC (ALTMODE) 

b) EZDTAhDEBUG.MAC (ALTMODE) 

Read a Page 

a) Y 

b) A 

Output Data 

a) PW 

b) 6P 

c) 12, SOP 

Pointer Positioning 

a) Y18J 

b) 5R 
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Open the input file colled SOURCE. MAC 
located on DTA5. 

Open the input file called SRCE.MAC 
located in area 12,24 on the disk. 

Open an input file on the paper tape 
reader , 



Open an output file on DTA3 and call 
it EDITED. MAC, 

Zero the directory on DTA1 , open an 
output file on it, and call the file 
DEBUG. MAC. 



Read a page into the buffer from the 
current input file, destroying the pre- 
vious contents of the buffer. 

Read a page into the buffer, appending 
the data to the end of the information 
currently in the buffer. 



Output the entire buffer, fo I lowed by 
a FORM character. 

Execute the write and read cycle six 
times. 

Write out the 13th through the 50th 
characters of the buffer. 



a) Read in a page of information and 
position the pointer after the 1 8th char- 
acter of the buffer; b) Then move the 
pointer left to between characters 13 

and 14. 



Delete Text 



a) J19C3D Move the pointer to the right of the 19th 

character In the buffer and then delete 

or the next three characters to the right 

(characters 20^ 21, and 22), 

b) 19,22K Delete the 19+1 (20th) through the 22nd 

characters of the buffer . 



Insert Text 

a) J 2LITAG: M OVE 1 , AMT^ 
( ALTMODE) 

b) 69\ 

c) CfAD ERROR IN JOB (ALTMODE) 

d) @I#ERDSK:PROG QMTMODE) ^ 



Move the pointer to a position following 
the second line of the buffer; insert the 
text ''TAG: MOVE i ,AMT" between 
the second and third lines of the buffer , 

Insert the digits "69' in ASCII at the 

current pointer position (same as 169 or 
541571). 

NOTE: \ is typed with a SHIFT fORA^ , 

Insert a tab foHowed by tlie text ''ERROR 
IN JOB'' at the current pointer position. 

Insert the text ^'ERDSKrPROG ( ^ItMOD! ) 
at the current pointer posiHon. 

NOTE: The use of delimiters is the only 

method for inserting an ALTMODE 
in the text » 



Typing Text 

a) 3T Assuming that the pointer is ol" the begin- 

• f i i ... L ff .. ... i .. i >. ! _ r* . i 1 ! 



Assuming that the pointer is or the begi 
ning of the buffer^ type out the first thr 
1 ines of the buffer . 



b) 25,100T Type out the 25+1 (26th) through the 

100th character of the buffer. 
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I EXAMPLES (BASIC) 



.R TECO^ 

'^ERDTAliSCFILE.MAC (ALTMODP ( ALTMODE) ^ 
*^EWDTA2:EDFILE.MAC (ALTMODE) (ALTMODE) ^ 



*Y0,20T (ALTMODE) (ALTMODE) ^ 



aaaaa aaaaa , 



*3LT (ALTMODE) (ALTMODE) ^ 
bbbbb bbbbb^ 



* ITHIS IS A S AMPLE INS ERT^ 
(ALTMODE) (ALTMODE) J 



MOPT ( ALTMODE ) ( ALTMODE) ^ 



ccccc ccccc ^ 



(ALTMODE) (ALTMODE) ^ 



'^200PPWEF (ALTMODE) (ALTMODE) j 



(ALTMODg) (ALTMODE) ^ 
EXITp 

.KJOB^ 



Open the flie called SC FILE, MAC on 
DTAl for 

Open an output tile on DTA2 and call 
It EDFILE.MAC, 

Reod a buffer of ^nformotlon from the 
Input file and type th^ ar- 
Qcters of the buffer, 

Mov e t he p * ^ ' ^ ' > : ^ - ' ^ ■ ■ r> ' n : 
when thre^^ ^ 
been encounte 
fourth line in ; 



text ot the 



insert the text ; iS A v'-- P 
ihsSERT^ betv/een the th ourti 
lines of the buffer and position the 
pointer after the inserted material . 

Write out the current buffer to the 
output device; read in ond v/rste out 
the next nine ''pages'' of . d in 

the 1 I th page of .o... c^n the 

pointer at the bf^c ■ ^he buffer; 

type out th. .ffer. 

Delete this line from the file; position 
rhe pointer at the beginning of the 
(nov/) first line in the buffer. 

Repeats the v/rite and read cycle 200 
times and v/rltes our the last page be-- 
fore terminating the output file. 

Return control to the Monitor ofter ol! 
output requests hove been completed. 



Kill the job^ deassign al! devices^ re- 
lease core . 
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I ADVANCED COMMANDS 



SEARCH COMMANDS 
Summary 

S text (ALTMODE) - Searches for text In current buffer only. 

N text (ALTMODE) - Searches for text through successive buffers by repeatedly writing out current 

buffer and reading in next buffer (P command). 

text (ALTMODE) - Searches for text through successive buffers by repeatedly reading in new 
bufferful of information (Y command). 

1 . All searches begin at the current location of the pointer. 

2. Modifiers: 

Each search command can be preceded by the modifier characters, : and/or@. 

: causes the search command to have a numeric value at completion; 

0 if the search has failed (the requested text was not found) or 

-1 if the search was successful (the requested text was found). 
@ indicates that the text to be matched is delimited by some character (same as in the @I 

command), 

3. Numeric Arguments: 

A numeric argument can appear following the modifiers (if any) but preceding the command. If 
the numeric argument is n, TECO searches for the nth occurrence of the text. If n is not used, 
the value of n is assumed to be "1 

4. Pointer Positioning: 

If search is successful, the pointer is positioned to the right of the matched text. 
If the search fails, the pointer is positioned at the beginning of the buffer. 

5. Use of Special Characters Within Text: 



^s 


Match any separotor characfer { 
sign, or percent symbol)* 


any character not a letter^ number^ period^ dollar 




Match any (arbitrary) character 
the text is unimportant* 


« Used when the contents of some position within 




- Match any character except x . 






- Takes the next character literal 


ly^ even if it is one of these four special characters^ 



For examp le, StQf X CALTMODE) - Find the charocterf X. 
NOTE: See note on page TECO-2. 
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Table TECO-1 Search Commands Summary 



Command 


Action at End 


Action at End 


Vol 


ues 


Typeout ? 




of Buffer 


of File 


Success 


Fail 


if Failure 


s 


Failure 


N/A 


N/A 


N/A 


Yes 


:S 


Failure 


N/A 


-1 


0 


No 


N 


Performs a P command 
and resumes search 


Fai lure 


N/A 


N/A 


Yes 


:N 


Performs a P command 
and resumes search 


Failure 


-1 


0 


No 




Performs a Y command 
(read only) and resumes 
search 


Failure 


N/A 


N/A 


Yes 




Performs a Y command 
(read only) and resumes 
search . 


Failure 


-1 


0 


No 



Q-REGISTER COMAAANDS 




Q registers are provided for storing quantities, command strings, or buffer contents for later use. Thirty- 
six Q registers, labeled 0 through 9 and A through Z, are available. 


nUi 


Places the numeric value n in Q-^reglster h . : ' . 




Qi 


Represents the current value in Q-reghter h 




%i 


Adds 1 to the value in Q-register i and represents the new value. 




m,nXi 


Copies characters m+1 through the nth character of the buffer into Q-regi 
Does not alter buffer contents or pointer^ 


ster I ^ 


nXi 


Copies the buffer characters between the current pointer position and the 

FEED character in Q-register 


nth LINE- 


Gi 

Ci 


Inserts the text contained in Q^-register i into the buffer beginning ot the 
pointer location. Set the pointer to the right of the insertion. 

Pushes the contents of Q -register i onto the Q -register pushdown list. 


current 


J' 


Pops the top entry of the Q-register pushdown list into Q-^register i. The 
pushdown list is cleared each time two successive ALTMODE^s ore typed. 


Q-register 
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MACRO, ITERATION, AND CONDITIONAL COMMANDS 


Mi 


Perform the text in Q-«register i as a series of commands. 


< > 


Iteration brockets* When > Is encountered^ command interpretation is sent bock 
to <. 


n <> 


Perform the commands within the iteration brackets n times. 




If not In fin itpmtion nn prrnr rP**^!! ts ff most rp'rc^nt search failed send command 
interpretation to just beyond the motching > on the right; otherwise^ no effect^ 


n; 


If not in an iteration, an error results* If the value of n is 0 or gxeo'tev ^ send corn-™ 
mand interpretation just past the matching > to the right; otherwise, no effecr. 


tagl 


Tag definition ^ Tag is the name of the locotion in which It appears in a command 
string * 


Otag (ALTMODE) 


Go to the named tog^ wliich must appear in the current macro or command string.. 


n"G 


^ ^5 0/ send command interpretation to the nexr matching \: if n M\. no et^'ect^ 


n"L 


If n > 0, send command inter pretotion to the next matci'iing'; '--O, no etiec:« 


n"N 


If n - 0^ send commsond interpretation to the next matching'^ If n -f 0^ no effect . 


n"E 


If n 7^ 0^ send command Interpretation to the next miatchtng"; v' ti - ^-^ no effeci . 


n"C 


If n IS not one of the symbol constituents (a letter^ m.nnber, period^ doMur sicin^ 
percent symbol), send command Interpretation to the nexr f.iarcMnq ot^'^erwlse , 

no effect . 


NOTE: The " and 


' symbols ore matched In the some way as the ( and ) symbols. 



NUMERIC VALUES AND ARGUMENTS IN COMMAND STRINGS 




Many command string formats permit arguments with numeric values. The following characters may ap- 
pear in a command string to develop these values in any instance where a numeric value is permissable. 


0 through 9 


Represent their corresponding numeric values* 




B 




Equivalent to 0. 




Z 




Equivalent to the number of characters in the buffer. 

Equivalent to the nutrhex of charocters to the left of the curres 
in other words , equal to the current pointer position). 


It poir^QX position (or 


Qi 




Equivalent to most recent numeric value placed in Q-^register 




nA 




Equivofent to ASCII volue of charocter to right of pointer; n i: 
this argument from on Append command (A) and has no other s 


used to differentiate 

gnificonce* 






Equivalent to value of elapsed time in 60ths of a second since 


midnight. 






Equiva!ent to the value of the console data switches . 
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NUMERIC VALUES AND ARGUMENTS IN COMMAND STRINGS (Cont) 


tE 


HqS the VOlue Ot the torm teed switch If davinn fhf^ ln<;f V r^r A rommonH 

execution, data transmission was terminated by a form feed character, has 
a value of -1, otherwise, the value is 0, 




(On Models 33 and 35, hold down both the CTRL and SHIFT keys and type "N".) 
Equivalent to the ASCII value of the next character in the command string; this 
character h not interpreted as a command. 




Stops command execution until user types a character on the Teletype; fT then be- 
comes equivalent to the ASCII value of fhe character typed. 


\ 


Equivalent to the value represented by the digits (or minus sign) immediately follow- 
ing the current pointer position. The value is terminated by the first nonnumeric 
choracter encountered. The pointer is positioned immediately foitowing the value. 


m+n 
m "" n 


Add I T i 

CI. . f lake one or tv/o arguments, A space is equal to +. 

kJ I 1 v»4 \^ I 1 


m*n 
m/ n 


Multiply I T i 

p.. .J /. ^ ; f lake one or two arguments. 
Divide (truncates; ^ 


m&n 


Logical AND; bitv/ise AND of binary representations m. and n. 




LoQiCal loR; bitwise inclusive ORof hinnrv rpnrp«;pntnt jonc m r«nrl ^ 


0 


(DperotorS "r, ^ / ^ nnri OTA nrirrvinlK' n^^rff^rmiP'rl l^^ff ^r-, ri/^hf TKfc Kiar^wo-r^r^o, 

can be overruled by use of parentheses, NOTE: TECO does not assume that mul»- 
tiplication and division ore always performed ' iddition and subtraction. 
Ihus, to obtain the equivalent ot a -t- (b cj. ..st use the parentheses; other- 
wise^ (a + b) c is assumed » 


n= 


Causes the value of n to be typed out. 


H 


Abbreviation for B, (0 through the last location of the buffer; in other words^ 
th e V/ ho i e bu f f er) ♦ 


NOTES: 


If 0 command takes two numeric arguments, a comma Is used to separate them. 



TECO TERMINATION COMMANDS 






^C ^ ..-rroi^o 


Hie h\oT\\\ov without waiting for 


any I/O operations to finish « 


(BELL) 


"he Mo 


output request ■ 
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STAND-ALONE EXAMPLES (ADVANCED) 



Search 

J3SMOVE (ALTMODE) IM (ALTMODE) 



Search for a Special Character 

a) S^NA (ALTMODE) 

b) S^S (ALTMODE) 

Q-Registe rs^ Macros^ Iterations^ and Conditionals 
a) JOUN<S CLINE-FEED) 

(ALTMODE) ; %NX3N= 



b) KSJUMPA (ALTMODE) ; -4DIRST CaLTMODE) > 



Within the current" buffer^ search for the 
third occurrence (3S) of the text "MOVE", 
position the pointer immediately after it, 
and insert an "M" at that po\n\ . 



Search for any character except A within 
the current buffer. 

Search for any separator character within 
the current buffer. 



Count the number of LINE-FEED char- 
acters in the buffer as follows: 

1 . Position the pointer at the be- 
ginning of the buffer (J), 

2. Place 0 in Q-register N (OUN), 

3. Perform a search for a LINE- 
FEED character ( S LINE-FEED 
ALTMODE); if one is found, 
add 1 to Q-register N (;%N). 
Go back (<>) and repeat this 
cycle until the end of the buf- 
fer is reached and the test foils 
(;); at this point type out the 
contents of Q-register N (QN-~). 

Replace all instances of the text " JUMPA" 
with " JRST" in the current buffer. 

1 . Position the pointer at the be- 
ginning of the buffer (J) . 

2* Search for JUMPA; when found, 
backspace the pointer four posi- 
tions and delete the four char- 
octers passed over (;-4D), 

3 . Replace these four characters 
with the characters "RST" (IRST). 

4. Repeat this routine (<>) until 
the test fails (end of the buffer 
has been reached) and exit (;) 
to >, 



TECO-14 



To Place a Command in a Q-Register for Later Execution 



@I#JOUN<S (LINE-FEED) 
;%NX3N=^HXP 



(ALTMODB ^ 



1. I nsert the te xt " JOUN<S C LINE-FEED) 
(ALTMODE) ;%N>QN-" into the 
buffer J) 

2. Copy the contents of the buffer into 
Q~register P (HXP), 



To Execute the Command: 



ERDTA3:FN.EX (ALTMODE) YMP 



1 . Read in a page of a file to sea rch. 
(ERDTA3:FN.EX (ALTMODE) Y) 

2. Execute the command stored in Q- 
register P (MP), 



To Read in Text to be Inserted in Several Places in a File and to Store it in a Q-Register 



ERPTR: (ALTMODE) YHXP(i 



ERDTA4:TXTEDT (ALTMODE) ^ 
EWDSKrTXTEDU (ALTMODE) j 

YNCALC: (ALTMODE) GPj 



NTOT: (ALTMODE) GP 



3„ 



4. 



Assume that the text to be inserted 
is on paper tape. Open an input 
file on the paper tape reader 
(ERPTR:); read the text into the 
buffer (Y); copy the contents of the 
buffer Into Q-register P (HXP), 

Open the input file to be edited 
and the output file to con\Q\n the 
edited version. 

Read a page from the input file and 
initiate a search for the text "CALC:^' . 
When found, insert the text stored in 
Q~register P at that point (GP). 

Search for the text "TOT:" and, when 
found, insert the text stored in Q~ 
register P after it . 
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EXAMPLES (ADVANCED) 



.R TECO ^ 



*ERMTA1: (ALTMODE) EM14EM (ALTM0DE)(ALTM0DE) j Select MTAI for Input; rewind tlie tape 

(EM) and advance the tape one ft!e 

^EZDTA1:REVFIL C ALTM0DE)( ALTMODD ^ i ^ . , 

*YNTAXRT (ALTMODE) OLT^ 
1X1 (ALTMODE) (ALTMODE) ^ 



aaaa . . . T AXRT aaaa aaaaa 



*JNTXRTE (ALTMODE) OLT^ 
G1 (ALTMODE) (ALTMODE) ^ 

bbb...TXRTE bbb bbbbb^ 



*NTXTEND: (ALTMODE) j 

KSA (ALTMODE) ;1 A-47"G1 A-58"L-DIB (ALTMODE) ' 
PWEF (ALTMODE ) (ALTMODE) j 



*tG (ALTMODE) (ALTMODE) } 
EXIT \ 

• KJOB^ 



lease co;C . 
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DIAGNOSTIC MESSAGES 



Table TECO-2 TECO Diagnostic Messages 



Message 



Meaning 



An illegal or otherwise meaningless command has been entered. 

TECO has ignored the remainder of the command string and has returned to the idle 



state , 



At this point, the user can type ? back in, causing TECO to type out the command 
string terminated by the bod command. 

NOTE: Search commands are considered illegal if they fall and the : modifier was not 
used; in this case, the message typed is "? SEARCH?". 



Table TECO-3 TECO Diagnostic Messages, File Definitions 



Message 



Meaning 



? OUTPUT ERROR 
? INPUT ERROR 



One of these two messages is typed, followed by an 
augment message below. 



DIRECTORY FULL 

filename. ext FILE BEING MODIFIED 
filename. ext FILE NOT FOUND^ 
filename. ext FILE PROTECT FAILURE 
ILLEGAL FILE NAME^ 

filename. ext INCORRECT PROJECT - 
PROGRAMMER NUMBER 

NO DEVICE ASSIGNED 

filename. ext UNDEFINED FILE REF 
ERROR 



The DECtape directory is full, has no room for another 
insert . 

The filename. ext is being rewritten or renamed. 

The filename. ext is not availableon the input device. 

The filename. ext was READA^RITE protected. 

On output only, the filename. ext given is not 
acceptable. (e.g., 0 filename) 

The project-programmer number given for a disk 
file is incorrect. 

No device was previously assigned for this file. 
The error given by the Monitor is not yet defined. 



Hhe messages below are extracted from data given by the monitor in response to ENTER and LOOKUP 
failures, modified by logic in some instances. 

2 

These may be defined in three ways: 

1 . If LOOKUP, the filename. ext cannot be found. 

2. If ENTER and the filename is not 0, the directory is full . 

3. Otherwise, the filename format is illegal. 
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Debugging Aids 

As an aid in debugging macros and iterations, TECO can be set in the trace mode by typing ? 
as any character other than the first in a command string. When in trace mode, TECO types out each 
command as it is interpreted, interspersed with requested output. Typing a second ? in the same manner 
takes TECO out of trace mode; the ? can be typed each time it is desired to change the current mode. 

The user can also type comments on his Teletype sheet as he executes TECO by typing: 

^Atext^A 

This causes all text entered to be printed on the Teletype (with the exception of terminating ^ A character). 



N 



OTE: Since the terminator ^ A is not a command, it must be typed by holding the CTRL key 
down while typing "A"; it cannot be entered as "up arrow. A." 



If DDT (Dynamic Debugging Technique program) has been loaded along with TECO by Linking 
Loader, control can be transferred to DDT by using the command 
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MACRO-tO ASSEMBLER (MACRO) 



To assemble source programs coded in the Macro- 10 
programming language and produce machine langu- 
age programs which are compatible with the Linking 
Loader and the Dynamic Debugging Technique pro- 
gram. 

• Sophisticated 2-pass assembly 

• Device independent 

• Complete macro instruction facilities 

• Symbolic linkage to other independently- 
generated programs 

• Unlimited indexed/indirect addressing and ex- 
panded address arithmetic 

• Ten data-generating pseudo-operations and 
eleven conditional assembly pseudo-operations 

• Object coding produced in either relocatable 
or absolute address format 

• Accepts input from any input device 



I ENVIRONMENT 



Monitor 


All 


Minimum Core 


5K 


Additional 
Core 


Automatically requests additional core assignments 
from the time-shoring monitor as needed. 


Equipment 
Required 


One input device (source program input). Two 
output devices (machine language program output 
and listing output). If the listing output is to be 
used as input to the Cross Reference (CREF) program, 
it must be written on either DECtape, magnetic 
tape, or disk. 
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INITIALIZATION 

,R MACRO^ 



COMMANDS 

General Command Format 
objprog-devrfilename .ext, I ist 

objprog-dev: 



I ist-dev: 



source-dev: 



Loads the Macro-"! 0 Assembler into core. 
The ossembter is ready to receive a command. 



■devrfiiename.exto — source-dev :fi lename .exf, 
source-n^ 



The device on which the object program is to be 
written . 

MTAn: (magnetic tape) 

DTAn: (DECtape) 

PTP: (poper tape punch) 

DSK: (disk) 

The deyice on which the assembly listing is to be 

written 

MTAn: (magnetic tape) Must be one of 

DTAn: (DECtape) f these if input 

DSK: (disk) j to CREF. 

LPT: (iine printer) 

TTY: (Teletype) 

The device(s) from which the source^program input 
to assembly is to be read« 

MTAn: (magnetic tape) 

CDR: (card reoder) 

DTAn: (DECtape) 

DSK: (disk) 

PTR: (paper tope reader) 

TTY: (Teletype) 

If more than one file is to be assembled from, o mag- 
netic tape, card reader, or paper tape reader, dev: 
is fonowed by a comtva for each file beyond the 
first. 

Input via the Teletype is terminated by typing 
CTRL Z (f Z) to enter pass 1; the entries must be re- 
typed at the beginning of pass 2. 
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filename. ext (DSK: and DTAn: only) 

The filename and filename extension of the object 
program file, the listing file, and the source file(s). 

<j The object program and listing devices are separated 

from the source device by the left arrow symbol . 



Disk File Command Format 



DSKrfilenome .ext [pro j, prog] 
[pro j, prog] 



Project-programmer number assigned to the disk area 
to be searched for the source file(s) if other than the 
user's project-programmer number. 

The standard protection^ is assigned to any disk file 
specified as output. 



Notes: 

If object coding output is not desired (as in the case where a program is being scanned for source lang- 
uage errors) , objprog-dev: is omitted . 

If an asse mbly listing is not desired , list-dev: is omitted . 



Standard protection (055) designates that the owner is permitted to read or write, or change the pro- 
tection of, the file while others are permitted only to read the file. 
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EXAMPLES 



•R MACROjJ 
*DTA3:OBJPRG,LPT: 



END OF PASS 1 ^ 



■CDR:J 



THERE ARE 2 ERRORS^ 
PROGRAM BREAK IS 002537^ 
5K CORE USED^ 

•KJOB^ 



.R MACRO^ 

*MTA3 : , MTA2 : <i MT A1 : , ,^ 

THERE ARE NO ERRORS^ 
PROGRAM BREAK IS 003552^ 
6K CORE USED^ 

*,LPT:0 DTA1:FILE1,FILE2,FILE5^ 

THERE ARE NO ERRORS^ 
PROGRAM BREAK IS 001027^ , 
6K CORE USED^ 

*,< DSK:FILE1 .MAC [14,12] J 

THERE ARE NO ERRORS^ 
PROGRAM BREAK IS 000544^ 
5K CORE USED^ 

• KJOBj^ 



Assemble one source program file from the card 
reader; write the object code on DTA3 and call the 
file OBJPRG; write the assembly 1 isting on the line 
printer . 

The source program cards must be manuolly refed for 
pass 2 . 

Number of source errors . Size of object program. 
Core used by assembler . 

Return to the Monitor . 

Kill the job, deassign all devices , and release core . 



Assemble the next three source files located at the 
present position of MTAl ; write the object program 
on MTA3; write the listing on MTA2 for later print- 
ing. 

Assemble the source files named FILET, FILE2, and 
FILES from DTAl; produce no object coding; write 
the listing on the line printer . 

Scan the source program called FILE 1 .MAC, loca- 
ted in area 14,12 on the disk, for source language 
errors; produce no object coding or assembly listing; 
print all error diagnostics on the Teletype. 

Return to the Monitor, 

Kill the job, deassign all devices, and release core. 



•R MACRO 
*MTA1:,TTY:< 

JMP R^ 
R: AOS G^ 
G: JFCL^ 

END^ 

END OF PASS 1^ 
JMP R^ 



TTY:J 



Enter the source 
statements 



Assemble a source file from the Teletype; v/rite the 
object code program on MTAl and print the assem- 
bly listing on the Teletype , 



Terminate input. 
Reenter Teletype input. 
Reenter the first statement. 
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• MAIN 

O 

R: 



AAACROX.H9 10:14 

000000 000000 000001 ' 
AOS 

000001 350000 000002' 

G: JFCg 

000002 255000 000000 

ENOp 

THERE IS 1 ERROR^ 

PROGRAM BREAK IS 000003^ 

• MAIN MACROX.H9 

SYMBOL TABLE^ 

G 000002 'j^ 

R 000001 'J 

5K CORE USEOp 
•KJOBj^ 



20-DEC-67 PAGE 1^ 
J MP 

R: AOS G^ 



G: JFCL 



10:14 20-DEC-67 PAGE 2^ 



Page heading. 
First assembled . 
Reenter second . 
Second assembled » 
Reenter third , 
Third assembled . 
Reenter fourth. 
Fourth assembled . 



Typeout of symbol toble. 



Return to the Monitor . 

Kill the job, deassign oH devices and release core. 
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SWITCHES 



Switches are used to specify such options as: 
1 . Magnetic tape control , 

2. Macro call expansion, 

3. Listing suppression, 

4. Pushdown list expansion, and 

5. Cross-reference file output. 

All switches are preceded by a slosh (/) (or enclosed in parentheses) and usually occur prior to the left 
arrow. 



Table MACRO-1 Macro-10 Switch Options 


Switch 


Meaning 


a' 
b' 
c' 


Advance magnetic rape ree< ^rse I'^e, 


Backspace magnetic tape reel by one fiie « 


Produce listing file in a format acceptable as input to CREF.^ 


E 


List macro expansions {same function as LALL pseudo-op). 


L 


Reinstate listing (used after list suppression by XLfST pseudo-op or S switch). 


N 


Suppress error printouts on the Teletype* 


P 


Increase the size of the pushdown list. This switch may appeor as many times 

as desired (pushdown list is initially set to a size of 80, ^ locations; each 

/P increases its size by 80,^). 

^ 10 


Q 


Suppress Q (questionable) error indications on the listing; Q messages in- 
dicate assumptions mode during pass 1 . 


S 

1 

T 

w' 


Suppress listing (same function as XLIST pseudo-op). 


Skip to the logical end of the magnetic tope. 


Rewind the magnetic tape. 


X 

z' 


Suppress all macro expansions (same function as XALL psuedo-op). 


Zero the DECfape directory. 


NOTES: 


1 . Must immediately follow the device or file to which it refers. 

2. Unless the file is named, CREF.TMP is assigned as the filename; if no 
extension is given, .TMP is assigned; if no list-dev: is specified, DSK : 
is assumed . 
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EXAMPLES 



,R AMCRO^ 

^MTA1:,DTA3:/C< — PTR:^ 



END OF PASS 1^ 

THERE ARE 3 ERRORS^ 
PROGRAM BREAK IS 000401^ 
5K CORE USEOp 



Assemble one source file from the paper tape readers- 
write the object code on MTAl; write the assembly 
listing on DTA3 in cross-reference format and call 
the file CREF.TMP. 

The paper tape must be refed by the operator for 
pass 2 . 

End-of-assembly messages. 



*DTA2:ASSEMB.ONE/Z,LPT:<*— MTA4:/W,^ 

THERE ARE NO ERRORS^ 
PROGRAM BREAK IS 005231^ 
6K CORE USED^ 

*MTA1:/W,LPT:<J MTA3:/W,(AA),(BB)^ 

THERE IS 1 ERROR^ 
PROGRAM BREAK IS 000655^ 
5K CORE USED^ 

.KJOB^ 



Rewind MTA4 and assemble the first two source files 
on it; write the object code on DTA2 , after zeroing 
the directory, and call the file ASSEMB.ONE; write 
the assembly listing on the line printer . 

Rewind MTAl and MTA3 and assemble files 1 , 4, and 
3 (in that order) from MTA3 . Print the assembly list- 
ing on the line printer . Write the object code on 
MTAl . 

Return to the Monitor . 
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DIAGNOSTIC MESSAGES 



Table MACRO-2 Macro-10 Diagnostic Messages 



Message 


Meaning 


7CANNOT ENTER FILE 
filename. ext 


DTA or DSK directory is full; file cannot be entered. 


9CANNOT FIND filename, ext 


The file cannot be found on the device specified. 


7COMMAND ERROR 


The last command string is in error. 


?DATA ERROR ON DEVICE dev: 


Output error has occurred on the device. 


(bell) END OF PASSl 


This message is issued prior to pass 2 whenever the 
input source file is on a medium which must be man- 
ually re-entered by the operator (PTR:, CDR:, TTY: ). 
When this message appears, the operator must refeed 
the tape or cards or retype the entries. 


? IMPROPER INPUT DATA 


The input data is not in the proper format. 


? INPUT ERROR ON DEVICE dev: 


Data cannot be read . 


r INSUFFICIENT CORE 


An insufficient amount of core is available for 
assembi y . 


nK CORE USED 


/-Nriiuurir oi core usea ror rnis assemoiy. 


(bell) load THE NEXT FILE 


Manual loading is required for the next card or 
paper tape file . 


?NO END STATEMENT 
ENCOUNTERED ON INPUT FILE 


The END statement is missing at the end of the 
source program file. 


?dev: NOT AVAILABLE 


The device is assigned to another user or does not exist . 


?PDP OVERFLOW, TRY/P 


A pushdown list overflow has occurred. 


PROGRAM BREAK IS nnnnn 


The highest relative location occupied by the object 
program produced. 


7THERE ARE n ERRORS 

THERE ARE NO ERRORS 
7THERE IS 1 ERROR 


1 


Number of source language errors found. 
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INSTRUCTION OPERATIONS 



The extensive PDP~10 instruction repertoire is structured around a design that implements all possible 
variations at the object code leveL Thus, instructions which odd or subtract may store the results 
either in an accumulator or in memory or both . Boolean operations admit all 1 6 combinations of two 
variables, while arithmetic compare and modify codes permit branching on the eight possible results. 
This logically complete instruction set contributes significantly toward reduction in program length and 
running time . 



Instruction List 

Instructions ore organized around basic operations, A mode is appended to the instruction mnemonic to 
specify the result destination, test conditions, and other options on the basic operation. 



Arithmetic and Logical 

Fixe d point arithmetic single precision and negative numbers are in 2s complement form. Double 
precision is facilitated by using the CRYO and CRY1 flags. which record the hardware -generated carries 
from bits 0 and 1 of the arithmetic unit. Overflow is recorded in the AROV flag. 



ADD (270) 

SUB (274) 

MUL (224) 

IMUL (220) 

DIV (234) 

IDIV (230) 



add 

subtract 
multiply 
integer multiply 
divide 

integer divide 



MODES 




combine (AC) and (E) 




results (AC) 


1 


Immediate 




combine (AC) and E 




results — ► (AC) 


M 


Memory 




combine (AC) and (E) 




results (E) 


B 


Both 




combine (AC) and (E) 




results (AC) and (E) 
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ADD 


(270) 


(AC) + (E) (AC) 


ADDI 


(271) 


(AC) + E (AC) 


ADDM 


(272) 


(AC) + (E) (c) 


ADDB 


(273) 


(AC) + (E) - (AC), (E) 


SUB 


(274) 


(AC) - (E) - (AC) 


SUBI 


(275) 


(AC) - E (AC) 


SUBM 


(276) 


(AC) - (E) -, (E) 


SUBB 


(277) 


(AC) - (E) ^ (AC), (E) 

High order part or the product 
is lost for all IMUL instructions. 
The overflow flag is set if the 
high order part is non-zero. 


IMUL 


(220) 


(AC) X (E) ^ (AC) 


IMULI 


(221) 


(AC) X E -» (AC) 


IMULM 


(222) 


(AC) X (E) (E) 


IMULB 


(223) 


(AC) X (E) ^ (AC), (E) 


MUL 


(224) 


(AC) X (E) ^ (AC), (AC+1) 


MULI 


(225) 


(AC) X E (AC), (AC+1) 


MULM 


(226) 


(AC) X (E) ^ (E) 

low order port discarded 


MULB 


(227) 


(AC) X (E) ^ (AC), (E) 

low order part — » (AC + 1) 

overflow occurs during IDIV 
only if the divisor is zero 


IDIV 


(230) 


(AC) ^ (E) (AC) 
remainder — » (AC + 1) 


IDIVI 


(231) 


(AC) - E (AC) 
remainder — ► (AC + 1) 


IDIVM 


(232) 


(AC) * (E) (E) 

remainder is discarded 


IDIVB 


(233) 


(AC) (E) (AC), (E) 

remainder — » (AC + 1) 


DIV 


(234) 


[(AC) + 2-35 (AC + 1)1 
^ (E) (AC) 

remainder --♦ (AC + 1) 
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DIVI (235) [(AC) + 2"^x (AC + 1)] 

■■^ E -* (AC) 

remainder (AC + 1 

DIVM (236) [(AC) + 2"^^ {AC + 1)1 

(E) (E) 

remainder is discarded 

DIVB (237) [(AC +2"^^ (AC + ])] 

+ (E)-* (AC), (E) 

remainder — ♦ {AC + 1) 

Floating Point Arithmetic - Exponents are excess 200g except that a 0 fraction will result in a 0 
exponent , Results are normalized except for UFA, Arithmetic flag indications are: 

AROV FOV FXU DCK 

110 0 floating exponent overflow 

110 1 floating divide check 

1110 floating exponent underflow 



Add, Subtract, Multiply 



FAD 


(140) floating add 


FSB 


(150) floating subtract 


FMP 


(160) floating multiply 


MODES 




result (AC) 


L 


Long 

double precision result (AC), (AC + 1) 
Sign and exponent of (AC + 1) are positive, 
27^ Q less than (AC) exponent, and not 
normalized 


M 


Memory 
result (E) 


B 


Both 

result (AC), (E) 
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Instruction Codes 



FAD 


(140) 


(AC) 




(E) 




(AC) 




FADL 


(141) 


(AC) 




(E) 




(AC), (AC + 


1) 


FADM 


(142) 


(AC) 




(E) 




(E) 




FADB 


(143) 


(AC) 




(E) 




(AC), (E) 




FSB 


(150) 


(AC) 




(E) 




(AC) 




FSBL 


(151) 


(AC) 




(E) 




(AC), (AC + 


1) 


FSBM 


(152) 


(AC) 


-» 


(E) 




(E) 




FSBB 


(153) 


(AC) 




(E) 




(AC), (E) 




FMP 


(160) 


(AC) 


X 


(E) 




(AC) 




FMPL 


(161) 


(AC) 


X 


(E) 




(AC), (AC + 


1) 


FMPM 


(162) 


(AC) 


X 


(E) 




(E) 




FMPB 


(163) 


(AC) 


X 


(E) 




(AC), (E) 





Divide FDV (170) floating divide 



MODES 




quotient — > (AC) 


L 


Long 

quotient (AC) 
remainder (AC + 1) 

sign of the remainder is the sign of the dividend 
Exponent of the remainder is 27^ ^ less than that 
of the dividend. 


M 


Memory 
quotient — ► (E) 


B 


Both 

quotient (AC), (E) 



Instruction Codes 

FDV 
FDVL 

FDVM 
FDVB 
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(170) (AC) (E) - (AC) 

(171) (AC)^ (E) -» (AC) 
remainder — ♦ (AC + 1) 

(172) (AC) . (E) -» (E) 

(173) (AC) * (E) (AC), (E) 



Rounded 



Instruction Codes 



FADR (144) floating odd and round 

FSBR (154) floating subtract and round 

FMPR (164) floating multiply and round 

FDVR (174) floating divide and round 



MODES 




rounded result (AC) 




1 


Immediate 

the second operand is E, left justified with 
in the right half of the word rounded result 


zeros 
-.(AC) 


M 


Memory 

rounded result — » (E) 




B 


Both 

rounded result (AC), (E) 





FADR 


(144) 


(AC) + (E) (AC) 




FADRI 


(145) 


(AC) + E - (AC) 




FADRM 


(146) 


(AC) + (E) (E) 




FADRB 


(147) 


(AC) + (E) - (AC), 


(E) 


FSBR 


(154) 


(AC) - (E) -* (AC) 




FSBRI 


(155) 


(AC) - E - (AC) 




FSBRM 


(156) 


(AC) - (E) (E) 




FSBRB 


(157) 


(AC) - (E) - (AC), 


(E) 


FMPR 


(164) 


(AC) X (E) - (AC) 




FMPRI 


(165) 


(AC) X E - (AC) 




FMPRM 


(166) 


(AC) X (E) -» (E) 




FMPRB 


(167) 


(AC) X (E) -» (AC), 


(E) 


FDVR 


(174) 


(AC) + (E) (AC) 




FDVRI 


(175) 


(AC) + E - (AC) 




FDVRM 


(176) 


(AC) 4- (E) (E) 




FDVRB 


(177) 


(AC) + (E) ^ (AC), 


(E) 
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Miscellaneous Floating Point 



unnormolized floating add. Same as FAD except 
that the result is not normalized, 

(AC) + (E) (AC + 1) 

double precision floating negate 

- [(AC), (E)] -* (AC), (E) 

the exponents are not changed 
floating scale 
2^x (AC)-^ (AC) 

Boolean 

All 16 boolean operations on two variables are provided. The contents of the accumulator and the 
operand are combined on a bit for bit basis. The table below gives the results for all operations. 



Operand Bit 


0 


0 


1 


1 


Accumulator Bit 


u 


1 
1 


u 


1 

1 


SETZ 


0 


0 


0 


0 


AND 


0 


0 


0 


1 


ANDCA 


0 


0 


1 


0 


SETM 


0 


0 


1 


1 


ANDCM 


0 


1 


0 


0 


SETA 


0 


1 


0 


1 


XOR 


0 


1 


1 


0 


lOR 


0 


1 


1 


1 


ANDCB 




0 


0 


0 


EQV 




0 


0 


1 


SETCA 




0 


1 


0 


ORCA 




0 


1 


1 


SETCM 




1 


0 


0 


ORCM 




1 


0 


1 


ORCB 




1 


1 


0 


SETO 




1 


1 


1 



UFA (130) 
DFN (131) 

FSC (132) 
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MODES 




combine (AC) and (b) 




r*aciiifc ^Ar*^ 


1 


Immediate 




r"omnIn^ lAl i nnn E 




zeros are assumed in the left half of the operand 




result (AC) 


M 


combine (AC) and (E) 




results — » (E) 


B 


combine (AC) and (E) 




results (AC) and (E) 



Instruction Codes 



SETZ 


(400) 


0 - (AC) 


SETZI 


(401) 


0 - (AC) 


SETZM 


(402) 


0- (E) 


SETZB 


(403) 


0 - (AC), (E) 


SETM 


(414) 


(E) - (AC) 


SETMI 


(415) 


E -» (AC) 


SETMM 


(416) 


(E) - (E) 


SETMB 


(417) 


(E)-» (AC), (E) 


SETA 


(424) 


(AC) -* (AC) 


SETAI 


(425) 


(AC) ~* (AC) 


SETAM 


(426) 


(AC) -* (E) 


SETAB 


(427) 


(AC) - (AC), (E) 


SETCA 


(450) 


(AC)' - (AC) 


SETCAl 


(451) 


(AC)'-* (AC) 


SETCAM 


(452) 


(AC)' - (E) 


SETCAB 


(453) 


(AC)'- (AC), (E) 


SETCM 


(460) 


(E)' - (AC) 


SETCMI 


(461) 


E' -» (AC) 


SETCMM 


(462) 


(E)' - (E) 


SETCMB 


(463) 


(E)' (AC), (E) 
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SETO 


(474) 


777777777777 „ (AC) 


SETOi 


(475) 


o 

///////// ///q ^ \A\^J 


SETOM 


(476) 


o 


SETOB 


(477) 


O 

J /////// N / J \AL.;^ 
o 


AND 


(404) 


(AC) A (E) (AC) 


ANDI 


(405) 




AN DM 


(406) 


(AL) A (t) (t) 


ANDB 


(407) 


(AC) A (t) "-^ (AC), (t) 


ANDCA 




(AC)' A (E) (AC) 


ANDCAI 


(411) 


\AC; A fc (AL) 


ANDCAM 


(41 2) 


(AC) A (b) (t) 


ANDCAB 


(413) 


(AC; A (t; — ^ (AC), (t) 


ANDCM 


(420) 


(AC) A (E)* ^ (AC) 


ANDCMI 


(421) 


\AC; At \ACj 


ANDCMM 


(422) 


\ALj A IL) (!:) 


ANDCMB 


(423) 


(AC) A (UJ (AL)^ (t) 


ANDCB 


(440) 


(AC)' A (E)' ~- (AC) 


ANDCBI 


(441) 


\ACj A c — ♦ (AC; 


ANDCBM 


(442) 


(AC; A i^tj --^ (Cj 


ANDCBB 


(443) 


(AL) A (t) (AL)^ (L) 


lOR 


(434) 


(AC) V (E) ^ (AC) 


lORI 


(435) 


\AL; V c (ALj 


lORM 


(436) 


(ALj V (cj (c/ 


lORB 


(437) 


(AL) V (t) ^ (AL)^ (t) 


lORCA 




(AC)^ V (E) ^ (AC) 


lORCAl 




(AL) V I: — * (AC) 


1 ORG AM 




(AL) V (k) --^ (t) 


lORCAB 




(AC) V (t) --♦ (AC), (t) 


lUKLM 




(AC) V (E)' - (AC) 


lORCMI 




(AC) V (E)' - (AC) 


lORCMM 




(AC) V (E)' -* (E) 


lORCMB 




(AC) V (E)' - (AC), (E) 
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lORCB 




(AC)' V (E)' - (AC) 


lORCBI 




(AC)' V E' 


(AC) 


lORCBM 




(AC)' V (E)' - (E) 


lORCBB 




(AC)' V (E)' - (AC), (E) 


XOR 


(430) 


(AC) © (E) (AC) 


XORI 


(431) 


(AC) © E -» 


(AC) 


XORM 


(432) 


(AC) © (E) (E) 


XORB 


(433) 


(AC) © (E) - (AC), (E) 


EQV 


(444) 




(AC) © (E)' 


' - (AC) 


EQVI 


(445) 




(AC) © e] ' 


(AC) 


EQVM 


(446) 




(AC) © (E)" 


' - (E) 


EQVB 


(447) 




(AC) © (E) 


' -» (AC), (E) 



Shifting 

Arithmetic shifts perform 2's complement multiplication. Overflow may occur when shifting left. Logi. 
shift inserts O's at one end and bits at the other end are lost. Rotate forms a ring so that bits are recyc 
The number of shifts is designated by E (considered as a 2's complement number). The direction is to t 
left if E is positive; to the right if E is negative . 

ASH (240) arithmetic shift 

ROT (241) rotate 

LSH (242) logical shift 



MODES 




shift (AC) 


C 


shift Combined accumulators. 




(AC) and (AC+1). (AC) is in 




the high order position. 




During arithmetic shifts the 




sign of AC+1 is set to the sign 




of AC, if the shift is non-zero. 



Instruction Codes 

ASH (240) arithmetic shift 

ASHC (244) arithmetic shift combined 

accumulators 

ROT (241) rotate 



MACRO-17 



rotate combined accumulators 
logical shift 

logical shift combined accumulators 



move full word 
move swopped word 
(left and right halves exchanged) 
move full word negative 
(2*s complement) 
move full word magnitude 



MODES 




source: (E) 




destination: (AC) 


1 


Immediate 




source: (0,E) 




destination: (AC) 


M 


Memory 




source: (AC) 




destination: (E) 


S 


Self 




source: (E) 




destination: (E) 




and also (AC) if the AC address is non-zero 



Instruction Codes 

MOVE (200) (E) (AC) 

MOV El (201) E — (AC)^ 

0 ~* (AC)j^ 

MOVEM (202) (AC) — (E) 



ROTC (245) 

LSH (242) 

LSHC (246) 

DATA TRANSMISSION 
Full Word 

MOVE (200) 

MOVS (204) 

MOVN (210) 

MOVM (214) 
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MOVES 


(203) 


(E) - (E) 






(E) -♦ (AC) if AC 7^ 0 


MOVS 


(204) 


(E)|_-* (AC)|^ 






(E)|^- (AC)l 


MOVSI 


(205) 


0 -» (AC)j^ 






E (AC)j_ 


MOVSM 


(206) 


(AC)|_-» (E)j^ 






(AC)|^ -♦ (t)^ 


MOVSS 


(207) 


(E)j_ (E)^ 






(E),- (E)^ 






(E) - (AC)„ and (E) ~* (AC) 

L K K L 






It AC ^ U 


MOVN 


(210) 


«-(t) --^ (AC) 


MOVNI 


(211) 


(AC) 


MOVNM 


(21 2) 


-(AC)-^ (E) ^ 


MOVNS 


(213) 


^(E)^(E) ■■ . 






-(E) (AC) if AC/ 0 


MOVM 


(214) 


|(fc}|-»CAC) 


MOVMI 


(215) 


E -» (AC) ' 


MOVMM 


(216) 


l(AC)| -» (E) 


MOVMS 


(217) 


1(E) 1 -(E) 






1(E) 1 (AC) if AC 0 ' ; 



Miscellaneous Full Word 

EXCH (250) (E) (AC) 

BLT (251) Bbck Transfer E-(AC) +1 

words from locations starting at 
(AC)j^ to locations starting at 
(AC)^ 

Note: if a priority interrupt 
occurs during this instruction 
then (AC) are indeterminate ♦ 
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Ha If- Word 

Half word transmission instruction codes are composed of a modifier and the mode. 



HLL 
HRR 
HRL 
HLR 



(500) half word left to left 

(540) half word right to right 

(504) half word right to left 

(544) half word left to right 



MODIFIER 




none 


Z 


set other half of destination word to Zeros 


o 


set other half of destination word to Ones 


E 


Extend sign of destination half-word to 




other half 




MODES 




source: (E) 




destination: (AC) 


1 


Immediate 




source: (0, E) 




destination: (AC) 


M 


Memory 




source: (AC) 




destination: (E) 


S 


Self 




source: (E) 




destination (E) 




and also (AC) if the AC field is non-zero 
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Instruction Codes 



HLL 


(500) 


(E)^^ (AC)^^ 


HLLI 


(501) 


0 - (ac)l 


HLLM 


(502) 


(AC),_- (E)^ 


HLLS 


(503) 


(E) -* (E) 

L 


HRR 


(540) 


(E),-(AC), 


HRRI 


(541) 


E - (AC)^ 


HRRM 


(542) 


(AC),-^ (E), 


HRRS 


(543) 


(E),- (E), 


HRL 


(504) 


(E)^ (AC)j_ 


HRLI 


(505) 


E (AC)|_ 


HRLM 


(506) 


(AC)^-* (E)j_ 


HRLS 


(507) 


(E),-(E)^ 


HLR 


(544) 


(E)^_^ (AC)^ 


HLRI 


(545) 


0 - (AC)^ 


HLRM 


(546) 


(AO^ - (E)^ 


HLRS 


(547) 




HLLZ 


(510) 


(E), - (AC), 






0 (AC) 

fx 


HLLZI 


(511) 


0 - {kC\ 






0 - (AC)^ 


HLLZM 


(512) 








O--(E), 


HLLZS 


(513) 








0 - (E)p 
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HRRZ (550) (E)j^ - (AC)j^ 

0 (AC)|_ 

HRRZI (551) E -> (AC)_ 

K 

0 - (AC)j_ 
HRRZM (552) (AC)^ - (E)|^ 

HRRZS (553) (E)^^ -» (E)p_ 

0 - (E)j_ 

HRLZ (514) (E)^- (AC)^ 

0 ^ (AC)^ 

HRLZI (515) E (AC)^ 

0 (AC)^ 
HRLZM (516) (AC)p^ - (E)^ 

0 - (E)^ 

HRLZS (517) (E)^-* (E)^ 

O-^(E), 

HLRZ (554) (E)^- (AQ^ 

0 (AC)^ 

HLRZ! (555) 0 - (AC). 

K 

0 -» {AC)j_ 
HLRZM (556) (AC) (E) 

0 (E)^ 

HLRZS (557) (E)^ (E)^^ 

0 -* (E)|_ 

HLLO (520) (E)^- (AC)^ 

777777g (AC)j^ 
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HLLOl 



HLLOM 



HLLOS 



HRRO 



HRROI 



HRROS 



HRLO 



HRLOl 



(521) 
(522) 

(523) 

(560) 

(561) 



HRROM (562) 



(563) 



(524) 



(525) 



0 (AC)^ 

777777^ ~» (AC) 
(AC)|_ - (E)|_ 

777777^ {l)^ 
777777^- {l)^ 
777777. -* (AC) 



R 



L 



E (AC) 



R 



777777^ - (AC)^ 

(AC) (E)„ 
^ 'r ^ ^R 

777777^-^ (E) 

777777^ -» (E)|_ 

(AC)j_ 
777777. -» (AC) 



R 



E - (AC), 



HRLOM (526) 



HRLOS 



HLRO 



(527) 



(564) 



777777g - (AC) 
(AC)j, (E)j_ 
777777g (E)^ 

(E)r- (E)l 

777777. -* (E)„ 
o K 

i\ -» (AC)^ 
777777^ -* (AC), 



R 



HLROI 



(565) 



E - (AC) 



R 



777777. -* (AC), 
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HLROM 



(566) 



777777^ 



(E). 



HLROS 



HLLE 



HLLEI 



HLLEM 



HLLES 



HRRE 



HRREI 



HRREM 



HRRES 



HRLE 



HRLEI 



HRLEM 



(567) 



(530) 



(531) 



(532) 



(533) 



(570) 



(571) 



(572) 



(573) 



(534) 



(535) 



(536) 



(E), - (E), 
777777^ ~* (E)^ 
(E)^ (AC)^^ 
i% - (AC)j^ 
0 - (AC)j^ 
0 - (AC)^ 
(AC)^ - (E)^ 
(AC)q - (E)^ 

(E)^ -* (AC)j^ 
(E)^g- (AC)^ 



E (AC) 
E 



"11 



R 

(AC), 



(AC)^- (E)j^ 
(AC),8-* i\ 

(E)^ - (AC)l 
(E),8- (AC), 



E -* (AC) 
E 



1! 



L 

(AC) 



R 



(AC)^ (E)^ 
(AC),g- (E)^ 
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HRLES (537) 

HLRE (574) 

HLREI (575) 

HLREM (576) 

HIRES (577) 



Byte Manipulation 

Byte manipulation instructions permit easy access to any number of contiguous bits anywhere in a single 
word. The size (S) and location (P) of the byte are specified by a pointer word designated by the 
effective address: 

0 5 6 11 f 14 17 18 35 

P S I X Y 

t 

Byte Pointer Word 

The and Y'-fie!ds of the pointer word are used in the usual manner to computer an effective 

address which is the location of the memory word containing the byte. The P-fleld specifies the number 
of bits between the right end of the word and the farthest right bit of the byte. The S-field specifies 
the size of the byte, up to 36 bits. To store and retrieve successive bytes, the pointer word incrementing 
instructions automatically subtract the size of the byte from P, moving the position to the right by one 
byte. If there is insufficient room in the memory word for the next byte (P-S<0), the Y-field of the 
pointer word is incremented by 1 and P is reset to 36- S* 

This instruction may be interrupted betv/een incrementing and the byte operation • The byte increment 
suppression (BIS) flag records the incrementing operation, and prevents its occurrence when returning from 
an interrupt. Note that this flag is under program control, and is restored by the JRST instruction. 



(E)j_^ (AC)p 
(E)q- (AC)l 
0 ^ {AQ^ 
0 (AO^ 
(AC)^ - (E)^ 
(AC)q- (E)^ 

(e)l-* {% 
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Instruction Codes 



LDB 



DPB 



IBP 



(135) LoaD Byte 

The byte is loaded into the 
accumulator right justified , 

Unused bits in the accumulator 
are cleared, 

(137) De Pes if Byte 

The byte in the accumulator is 
deposited in the memory word * 
Unused bits in the memory 
word are not affected, and the 

unused ^/^^ V' accumulator 
need 

(133) 

if P-S >0 then P-S --^ p 



I LDB 



IDPB 



(134) Increment and LoaD Byte 

Same as IBP followed by LDB 
(136) Increment and DePosit Byte 

Same as IBP followed by DPB 



EXECUTIVE 



Arithmetic Compare and Modify 

SKIP tests the (E) against 0 and skips 1 instruction location if the conditicn-- 
satisfied, AOS and SOS odd 1 or subtract 1 from (E) before testing. JU;. , 



^'ed by the mode are 
^i\d designated 



accumulator. AOJ and SOJ add 1 or subtract 1 from (AC) and then jump if the test is satisfied. 



SKIP (330) SKIP if condit ions specified by 

the mode ore satisfied by (E) , 
(E) (AC) if AQ^O, 

JUMP (320) JUMP if conditions specified by the 

mode are satisfied by (AC) . 

AOS (350) Add One to memory and Skip. 

(E)+l ^ (AC) if AC,^0. 

SOS (370) Subtract One from memory and 

Skip. (E)-] ^ (AC) if AC^O. 

AOJ (340) Add One to (AC) and Jump, 

SOJ (360) Subtract One from (AC) and Jump, 
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CAM (310) Compare Accumulator to 

Memory and skip . 

CAI (300) Compare Accumulator Imme- 

diate and skip. 



MODES 




never 


L 


Less than 


E 


Equal to 


LE 


Less than or Equal 


A 


Always 


GE 


Greater than or Equal 


N 


Not equal 


G 


Greater than 



Instruction Codes 



SKIP 


(330) 


(E) (AC) if AC?^0 


SKIPL 


(331) 


(E) -» (AC) if kC^Q 






skip if (E) <0 


SKIPE 


(332) 


(E) - (AC) if AC/0 






skip if (E):-0 


SKIPLE 


(333) 


(E) - (AC) if AC/0 






skip if (E) <€ 


SKI PA 


(334) 


(E) (AC) if AC/0 






always skip 


SKiPGE 


(335) 


(E) (AC) if AC/0 






skip if (E) > 0 


SKIPN 


(336) 


(E) -» (AC) if AC/0 






skip if (E)/0 


SKIPG 


(337) 


(E) (AC) if AC/0 






skip if (E) >Q 


JUMP 


(320) 


No action 


JUMPL 


(321) 


E ~» PC if (AC) < 0 


JUMPE 


(322) 


E -» PC if (AC) = 0 


JUMPLE 


(323) 


E -♦ PC if (AC) < 0 



MACRO-27 



JUMPA 
JUMPGE 
JUMPN 
JUMPG 

AOS 
AOSL 



AOSE 



AOSLE 



AOSA 



AOSGE 



AOSN 



AO SO 



SOS 



SOSL 



SOSE 



(324) E - PC 

(325) E PC if (AC) > 0 

(326) E - PC if (AC) ^ 0 

(327) E -» PC if (AC) > 0 

(350) (E) + 1 -» (E) 

result — ' (AC) if AC ,?^ 0 

(351) (E) + 1 (E) 

result — » (AC) if AC 0 
skip if result < 0 

(352) (E) + 1 -* (E) 

result - (AC) if AC 7^ 0 
skip if result = 0 

(353) (E) + 1 - (E) 

result - (AC) if AC / 0 
skip if result < 0 

(354) (E) + 1 - (E) 

result (AC) if AC 0 
always skip 

(355) (E) + 1 -» (E) 

result (AC) if AC 0 
skip if result > 0 

(356) (E) + 1 - (E) 

result -♦ (AC) if AC 7^ 0 
skip if result ^ 0 

(357) (E) + 1 - (E) 

result -■♦ (AC) if AC 7^ 0 
skip if result > 0 

(370) (E) - 1 - (E) 

result -♦ (AC) if AC 0 

(371) (E) - 1 - (E) 

result (AC) if AC f- 0 
skip if result < 0 

(372) (E) - 1 - (E) 

result -» (AC) if AC / 0 
skip if result = 0 
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SOSLE (373) 



SOSA 



SOSN 

SOSG 

AOJ 
AOJL 

AOJE 

AOJLE 

AOJA 

AOJGE 

AOJN 

AOJG 

SOJ 
SOJL 

SOJE 



(374) 



SOSGE (375) 



(376) 

(377) 

(340) 
(341) 

(342) 

(343) 

(344) 

(345) 

(346) 

(347) 

(360) 
(361) 

(362) 



(E) - 1 -* (E) 

result- -» (AC) if AC ^ 0 

skip if result < 0 

(E)-1 (E) 

result- (AC) if AC 0 

always skip 

(E) - 1 (E) 

result (AC) if AC 0 

skip if result > 0 

(E) - 1 (E) 

result (AC) if AC 0 

skip if result / 0 

(E) - 1 - (E) 

result -* (AC) if AC / D 

skip if result > 0 

(AC) + 1 -» (AC) 

(AC) + 1 -» (AC) 

E PC if result < 0 

(AC) + 1 (AC) 

E -» PC if result = 0 

(AC) + 1 -♦ (AC) 

E PC if result < 0 

(AC) + 1 -» (AC) 

E - PC 

(AC) + 1 -* (AC) 
E PC if result >0 
(AC) + 1 (AC) 
E -♦ PC if result ^ 0 
(AC) + 1 -» (AC) 
E PC if result >0 
(AC) - 1 (AC) 
(AC) - 1 -» (AC) 
E - PC if result <0 
(AC) - I (AC) 
E - PC if result = 0 
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SOJLE 
SO J A 
SOJGE 
SOJN 
SOJG 

CAM 

CAML 

CAME 

CAMLE 

CAMA 

CAMGE 

CAMN 

CAMG 

CAI 

CAIL 

CAIE 

CAILE 

CAIA 

CAIGE 

CAIN 

CAIG 

The following two instructions add 1 
codes, 

AOBJP 
AOBJN 



(363) 


(AC) - 1 - (AC) 




E — PC if result <0 


(364) 


(AC) - 1 -» (AC) 




E -* PC 


(365) 


(AC) - 1 -» (AC) 




E -» PC if result >0 


(366) 


(AC) - 1 - (AC) 




E -♦ PC if result ^ 0 


(367) 


(AC) - 1 -» (AC) 




E -» PC if result >0 


(310) 


No action 


(311) 


skip if (AC) < (E) 


(312) 


skip if (AC) = (E) 


(313) 


skip if (AC) < (E) 


(314) 


always skip 


(315) 


skip if (AC) > (E) 


(316) 


skip if (AC) ^ (E) 


(317) 


skip if (AC) > (E) 


(300) 


No action 


(301) 


skip if (AC) < E 


(302) 


skip if (AC) = E 


(303) 


skip if (AC) < E 


(304) 


always skip 


(305) 


skip if (AC) > E 


(306) 


skip if (AC) ^ E 


(307) 


skip if (AC) > E 



to both halves of (AC) and then test and jump , There are no mode 

(252) Add One to Both and Jump if Positive 

(AC) + 1000001,,-* (AC) 
o 

E - PC if result >0 

(253) Add One to Both and Jump if Negative 
(AC) + 1 000001 g-* (AC) 

E --♦ PC (f result <0 
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Logical Compare and Modify 

Accumulofor bits corresponding to 1 -bits in a mask can be modified or tested to determine a skip. The 
source of the mask is designated by the second letter of the instruction code mnemonic: 

D ^ Direct memory word specified by (E) 

S (E) With right and left halves Swapped 

L A word with E in the Left half, zeros in the right half. 

R A word with E in the Right half, zeros in the left half. 

The masked bits of the accumulator may be modified as indicated by the third letter of the instruction 
mnemonic: 

N No modification 

Z set masked bits to Zero 

O set masked bits to One 

C Complement masked bits 

The skip condition is specified by the mode (fourth letter of mnemonic) . 



MODES 




never skip 


E 


all masked bits are Equal to zero 


A 


Always skip 


N 


Not all masked bits equal to are zero 



Instruction Codes 



TDN 


(610) 


No action 


TONE 


(612) 


skip if (AC) ^ (E) - 0 


TDNA 


(614) 


always skip 


TDNN 


(616) 


skip if (AC) (E) 5^ 0 


TSN 


(611) 


No action 


TSNE 


(613) 


skip if (AC) ^ (E)^ = 0 


TSNA 


(615) 


always skip 


TSNN 


(617) 


skip if (AC) ^ (E)^ / 0 


TLN 


(601) 


No action 


TLNE 


(603) 


skip if (AC)j^'^ E = 0 


TLNA 


(605) 


always skip 
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TLNN 

TRN 

TRNE 

TRNA 

TRNN 

TDZ 

TDZE 

TDZA 

TDZN 

TSZ 
TSZE 

TSZA 

TSZN 

TLZ 

TLZE 

TLZA 
TLZN 

TRZ 

TRZE 

TRZA 
TRZN 



(607) 
(600) 
(602) 
(604) 
(606) 
(630) 
(632) 

(634) 

(636) 

(631) 
(633) 

(635) 

(637) 

(621) 
(623) 

(625) 

(627) 

(620) 
(622) 

(624) 

(626) 



skip if (AC)^^ E ^ 0 
No action 

skip if (AC)|^ ^ E = 0 

always skip 

skip if (AC)|^ ^ E 0 

(AC) ^ (E)' -4 (AC) 

skip if (AC) A (E) = 0 

(AC) ^ (£)'-» (AC) 

always skip 

(AC) A(E). (AC) 

skip if (AC) ^ (E) 7^ 0 

(AC) ^E)' - (AC) 



(AC) '^(E)' 



skip if (AC) ^ (E)^ = 0 



(AC) 

:e)3 = 

(AC) 



(AC) A(E)- 
always skip 



(AC) A(E)' - (AC) 
skip if (AC) A (E)^ ^ 0 
(AC) ME)'3- (AC) 
(AC)^ A E' - (AC)j_ 

skip if (AC)j^ ^ E = 0 



(AC)^^ A E' . 

always skip 

(AC), A E' - 

L 



(AC), 



(AC), 



skip if (AC)j^ A E *'0 

(AC), A E' 

L 

(AC)j^ Ag. 



(AC)^ 

(AC), 



skip if (AC)_ A E .- 0 



(AC)j^ ^E' - 

always skip 
(AC)^ ^E'- 



(AC) 



skip if (AC). A E^O 

K 
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TDO (670) 

TDOE (672) 

TDOA (674) 

TDON (676) 

TSO (671) 

TSOE (673) 

TSO A (675) 

TSON (677) 

TLO (661) 

TLOE (663) 

TLOA (665) 

TLON (667) 

TRO (660) 
TROE (662) 

TROA (664) 

IRON (666) 

TDC (650) 
TDCE (652) 



(AC) V (E) -» (AC) 
skip if (AC) ^ (E) = 0 
(AC) V (E) - (AC) 
always skip 
(AC) V (E) - (AC) 
skip if (AC) ^ (E) 0 
(AC) V (E) - (AC) 
(AC) V (E)^ (AC) 
skip if (AC) ^ (E)^ = 0 
(AC) V (E)^ (AC) 
always skip 
(AC) V (E)^ -» (AC) 
skip if (AC) ^(E)^/0 
(AC) V (E)^ -» (AC) 

(AC)|_ V E -» (AC)j_ 

skip if (AC)|_ E = 0 
(AC)^ V E - (AC)^ 

always skip 

(AC)j_ V E -» (AC)^ 

skip if (AC)|_ ^ E ?^ 0 
(AC)j_ V E -» (AC)j_ 

(AC)^ V E - (AC)^ 

skip if (AC)^ ^ E = 0 
(AC)^ V E - (AC)j^ 

always skip 

(AC)^ V E - (AC)^ 

skip if (AC)j^ V E ^ 0 
(AC)^ V E (AC)^ 

(AC) © (E) - (AC) 
skip if (AC) ^ (E) = 0 
(AC) © (E) -» (AC) 
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TDCA (654) 

TDCN (656) 

TSC (651) 

TSCE (653) 

TSCA (655) 

TSCN (657) 

TLC (641) 

TLCE (643) 

TLCA (645) 

TLCN (647) 

TRC (640) 

TRCE (642) 

TRCA (644) 

TRCN (646) 



always skip 

(AC) © (E) (AC) 

skip if (AC) A(E)j^o- 

(AC) © (E) (AC) 

(AC) © (E)j - (AC) 

skip If (AC) '^ (E)j=:0 

(AC) © (E)^ ^ (AC) 

always skip 

(AC) © (E)^ (AC) 

skip if (AC) A (E)S ^ 0 

(AC) © (E)^ ~* (AC) 

(AC)j_ © E - (AC)^ 

skip if (AC)^ E = 0 
(AC)^ © E (AC)| 

always skip 

(AC)^ © E - (AC)|_ 

skip if (AC)^ ^ E ^0 
(AC)^ © E - (AC)^ 

(AC)p^ © E .-^ (AC)^ 

(AC)p^ @ t ^ (AC) ^ 

always skip 
(AC)j^©E-^(AC)j^ 

skip if (AC)^ ^E/-0 
(AC)j^ © E (AC)j^ 



Inter-Program Tran sfer 

In the following descriptions, a reference to flags refers to a half-word quantity described as foil 



bit 0: 


AROV 


bit 5: 


User Mode 


bit 1: 


CRYO 


bit 6: 


User Mode lOT 


bit 2: 


CRY1 


bit 11: 


FXU 


bit 3: 


FOV 


bit 12: 


DCK 


bit 4: 


BIS 


and Os 


elsewhere. 
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JSR (264) Jump to SubRoutine 

flags (E)j^ 

PC (E)|^ 

then E + 1 PC 
JRST (254) Jump and ReSTore 

This instruction may be used 
as the return from a JSR or 
JSP. The AC-field determines 
additional functions: 
If ACIO (bit 9=1) reset the 
current priority interrupt 
channel • 

If AC4 (bit 10= 1) then halt 
If AC2 (bit 11=1) then 
restore flags. Indirect 
addressing or indexing must be 
specified if AC2 is designated. 
If ACl (bit 12=1) then set 
user mode flag. 

JSP (265) Jump and Save Program 

counter 

PC - (AC)^ 
flags -» (AC)^_ 
E PC 

JSA (266) Jump and Save Accumulator 

(see JRA for return) 



(AC) - (E) 
PC -» (AC)^ 

■ - , ' E (AC), 

E + 1 -» PC 

JFFO (243) Jump if Find First One 

If (AC)= 0, 0 AC + 1 



If (AC) 7^0, 

[the bit position of the leftmost 1 of (AC)] AC +1 
E PC 
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JRA (267) Jump and Restore Accuinulafor 

(used OS a return for JSA) 

t PC 

((AC)^) ^ (AC) 

JFCL (255) Jump and Clear Flags if any 

flag selected by the AC field 
is a 1 then E PC and the 
selected flogs are cleared 
AC -fie Id flag assignments. 

bit 9: arithmetic overflow 

bit 10: carry 0 

bit 11: carry 1 

bit 1 2: floating overflow 

Note: See PUSHJ and POPJ under pushdown operations for completely recursive subroutine operations. 
Push Down List 

Ihe p.. <^ overflow flag is set if a carry from bit 0 of the accumulator occurs during incrementing 

or de:: ^g. Bit assignments for flags are shown under the inter-program transfer instructions. 

PUSH (261) PUSH 

(AC) + 1 000001 g (AC) 
then (E) ^ ((AC)j.) 
POP (262) POP 

((AC^) ^ (E) 

then (AC)- 1000001^ (AC) 
o 

PUSHJ (260) PUSH and Jump 

(AC) + 1 000001 o — (AC) 
o 

then PC ((AC)„) 
R 

flags ((AC)j_) 
E -» PC 

POPJ (263) POP and Jump 

((AC)j^)r-PC 

then (AC)- 1 000001 g - (AC) 
Execute 

XCT (256) execute the instruction at (E). 

This may be another XCT 
instruction 
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INPUT/OUTPUT 



inpuT/ourpur instructions address devices connected to the input/output bus. Each device contains a 
device status register (DSR) which records commands from the central processor and contains the status 
of the device (e.g. interrupt request, activity, errors). Data is transferred through the data buffer 
register (DBR) located at the device, and may consist of from one to 36 bits depending upon the nature 
of the device. The central processor and the priority interrupt system are regarded as devices (addresses 



000 and 004^ respectively), 
o 

CONO 



CONI 



DATAO 



DATAI 



CONSZ 



CONSO 



BLKI 



(700) 
(700) 
(700) 
(700) 
(700) 

(700) 

(700) 



CONditions Out 

E -* (DSR) 

CONditions in 

(DSR) (E) 

DATA Out 

(E) (DBR) 

DATA In 

(DBR) ^ (E) 

CONditions in and 
Skip if Zero 

skip if (DSR) A E = 0 

CONditions in and 
Skip if One 

skip if (DSR) A E^O 

BLocK In 

The effective address is used 
to locate a pointer v^ord. The 
left half of the pointer word 
contains the word count and 
the right half holds the 
operand address. 

(E) + 1000001 g (E) 

then (DBR) ^ {{E)^) 

If not executed in a priority 
interrupt cycle, then skip 
if a carry occurred from bit 0 
when incrementing the pointer 
word. If in priority interrupt 
cycle and overflow occurred then 
execute next instruction after trap 
location. If in program interrupt 
cycle and overflow did not occur, then 
dismiss interrupt and return to the inter- 
rupted sequence . 
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BLKO (700) BLocK Out 

same as BLKI except- 
{(E)^) (DBR) 

Central Processor 

The central processor is addressoble as on inpyt/oufpuf device with address 000^. The input/output 
instructions are used for console operations, loading the memory protection and relocation registers, 
ond processing machine flags. MACRO-10 assembly language notation is used in the following discussic 

DATAI APR, ADDRESS 

The contents of the console dota switches are stored In the effective address • 
DATAO APR, ADDRESS 

Bits 18-25 of the contents of the effective address are stored in bits 18-25 of the relocation register. 
Bits 0-7 are stored in bits 18-25 of the memory protection, register , 

CONI APR, ADDRESS 

The contents of the effective address bits 19-35 are replaced. Unused bif positions are cleared. 



(E) bit 


Value 


33-35 


processor interrupt- chuhiisi assignment 


32 


arithmetic overflow flag 


31 


arithmetic overflow interrupt enable flag 


30 


not used 


29 


floating overflow flag 


28 


floating overflow interrupt enable flag 


27 


not used 


26 


clock flog 


25 


clock interrupt enable flag 


24 


not used 


23 


non-existent memory flag 


22 


memory protection violation flag 


21 


address break flag 


20 


user mode lOT flag 


19 


push down overflow flag 
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CONO APR, ADDRESS 

The bits of the effective address, E, perform the indicated functions. 



(E) bit 


Function 


33-35 


assigns the processor to an interrupt channel 


32 


clears arithmetic overflow flag 


31 


sets arithmetic overflow interrupt enable flag 


30 


clears arithmetic overflow interrupt enable fl( 


29 


clears floating overflow flag 


28 


sets floating overflow interrupt enable flag 


27 


clears floating overflow interrupt enable flag 


26 


clears clock flag 


25 


sets clock interrupt enable flag 


24 


clears clock interrupt enable flag 


23 


clears non-existent memory flag 


22 


clears memory protection violation flag 


21 


clears address break flag 


20 


not used 


19 


transmits a reset signal to all I/O devices 


18 


clears push down overflow flag 



Priority Interrupt System 

The priority interrupt system is addressable as device 004g (PI). 

DATAI PI, ADDRESS 
Zeros ore stored in (E). 

DATAO PI, ADDRESS 

The (E) ore displayed at the console on the memory indicator lights. 
CONI PI, ADDRESS 

The (E) pre replaced. Unused bit positions are cleared. 
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(E) bit Value 

35 channel 7 has been enabled 

• * 

29 channel 1 has been enabled 

28 priority interrupt system is on 

27 interrupt in progress on channel 7 

• ♦ 

• • 

21 interrupt in progress on channel 1 

20 memory pority error interrupt e noble flag 

1 9 memory parity error flag 

1 8 power failure flag 



CONO PI, ADDRESS 

The (E) perform the indicated functions. 



(E) bit Function 

35 selects channel 7 for bits 24, 25, 26 

• * 

• • 

29 selects channel 1 for bits 24, 25, 26 

28 turn on priority interrupt system 

27 turn off priority interrupt system 

26 disable selected channel 

25 enable selected channel 

24 initiate an interrupt on selected channel 

23 clear (reset) priority interrupt system 

22 not used 

21 set memory parity error interrupt enable fi 

20 clear memory parity error interrupt enable 

1 9 clear memory parity error flag 

1 8 clear power failure flag 
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INSTRUCTION LIST 



ADO 

SUB troct 
MULt iply 
j.nt«g«r MUL tiply 
OlVid* 

J^nt«g«r Div ide 



Floating AD d 
floating ^u^tract 
floating Multiply 
f looting ^iVide 



IjRou n ^I^J^" 



floating SCoU 
Rouble ^looting Ji^QOte 
^nnormalized f^loating ^dd 



Xmrned iota 

M^emory 

Both 



L.ong 

Memory 

Both 



Z.ero» 

Akccum. 
M^emory 
Qpmp. _Accum. 
£omp. M^emory 



EQuiVolence 
exclusive OR 



AND 

inclusive OR 



£omp. Akccum. 
£omp. ^enf>ory 
C.omp. _Both 



J^mmed iote 

M[emory 

Self 



Arithmetic SHift 
logical SHift 
ROTote 



E 

N^egote 

M^ognitude 
Swop 



iioif^] jlight 



Right 

_L... J 



Ones 
Z^eros 
Extend 



Immediate 

M^emory 

Self 



BLoch Transfer 

EXCH onge occum. -memory 



^ L.00D -Byte 



_[ncrsment OePosit ^yte 



^ncrsment _Byte pointer 



SKIP 
JUMP 

Add £ne and ^Kip 
A6d One and «Jump 
^Subtract Qn* ond^kip 
Subtract One ond J^ump 



C.ompare ^Accuf" w'f^ M.emory 
Compare A^cum. Immediate 



j.ess 

E^quol 

L,ess or £qual 

Always 

G.reater 

Greater or ^quol 
N,ot equal 



Add One to B.oth halves and J,ump if — ^ positive 



Test occum. with 



^irect memory 
S^wopped memory 
^ight immediote 
Left immediate 





N^othing 






.set 


Zeros 


,skip 


Always 




Ones 




if E,quol 0 




Complement 




if Not 0 



^ump to S^ubRoutine in memory, 

save program counter/stotus in memory. 
J^ump, ^ove Program counter/status in occum. 
Jump, Save Accum. in memory, 

sove program counter/status in occum. 
Jump, ^eset Accum. from memory. 
J,ump on f.lags, CL.ear flogs. 
J[ump and ReSTore flogs. 



PUSH [ 

POP J I Jun 



eX^eCuTe instruction from memory 



CON ditions 



BLocJ< 
DATA 



1" 
Out 

.Skip if ^eros 
Skip if Ones 



in 
Out 
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SYMBOLS 

(A) contents of A 

(A)|^ left half of (A) 

(A)|^ right half of (A) 

(A)^ contents of A with left and right 
halves swapped 

^ boolean AND 

V boolean inclusive OR 

© boolean exclusive OR 

* boolean inversion 

+ arithmetic addition 

arithmetic subtraction 

X arithmetic multiplication 

-i- arithmetic division 

I I arithmetic magnitude 

(A) ►(B) contents of A replaces contents of B 

AC accumulator 

E effective address 

= equal 

7^ not equal 



MAGRO-42 



MACRO ASSEMBLY STATEMENTS 



Symbols 



Direct Assignment Statement 
Numbers 



1 . 
2. 



One to SIX characters in length 

Composed of characters from the set: 
A through Z 
0 through 9 
$ (dollar sign) 
% (percent symbol) 
. (point) 

First character cannot be a digit; if first char- 
acter is a period, second character cannot be 
a digit. No imbedded spaces are allowed. 



symbol 



jlue 



2^radix^ 10 

RADIX statement - Used to set radix for numbers 
which follow 

To set radix for single numeric term: 



f Dnn 
tOnn 
^Bnn 

Binary shifting: 

nnBb 



-nnBb 



Decimal 

Octal 

Binary 



Place the number nn in a word, 
placing the rightmost bit of 

the number in bit "b*' 



Same as above but store the 
2's complement of the number 

Floating point decimal numbers: 

nnnEe Store the number as a floating 

point decimal number with the 
signed exponent "e" 

Any string of digits containing 
a decimal point is also stored 
as a floating point decimal 
number. 

Fixed point decimal numbers: 

"fFnnrunnBb Assembler places value into 
two 36-bit registers, with the 
integer portion in the left reg- 
ister and the fractional portion 
in the right register. The value 
is then stored in one word, with 
the assumed decimal point set 
after bit "b" in the storage word . 
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Arithmetic and Logical Operators; 



Address Assignments 



/ 
& 

! 

Order of Evaluation: 



Add 

Subtract 
Multiply 
Divide 
AND 

Inclusive OR 



Expressions enclosed in angle brackets, 
beginning with the innermost pair 

Unary operations (leading + or ~) 

Binary shifts 

Logical operations (left to right) 
Multiplication and division (left to right) 
Addition and subtraction (left to right) 

Numeric term; a digits a string of digits, or an 

expression enclosed in angle brackets 

Assigns addresses consecutively 

Location counter: , (point) 

Indirect addressing: ^a) adr 

Indexing adr(n) where n - 1 through 17 

Literal: [^data-generating expressionj 



Primary Instruction Format 



12 ♦ ' 



INSTRUCTION 
PART 



ACCUMULATOR 



INDIRECT BIT 



INDEX 
REGISTER 



ADDRESS 
PART 
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Input/Output Instruction Format 



I/O INSTRUCTION 



DEVICE 
SELECTION 



INSTRUCTION 
PART 



INDEX 
REGISTER 



ADDRESS 
PART 



• 10 12 ♦ ' 



INDIRECT BIT 
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SUMMARY OF PSEUDO-OPS 



ASCII 


Seven-'bii AbCil text. 


ASCIZ 


Seven-bit ASCII text, with null character guaranteed at end 


BLOCK 


Reserves blocK or storage cells. 


BYTE 


Input bytes or length 1 through 60 bits. 


DEC 


Input decimal numbers . 


DEFINE 


Defines macro . 


DEPHASE 


Terminates PHASE relocation mode . 


ENTRY 


Enters subroutine library . 


EXP 


Input expressions . 


EXTERN 


Identifies externa! symbols. 


Conditional Assembly Statements 






Assemble If: 


IFl 


Li^^^'u^i iv^i during pass 1, 


IF2 


Encountered during pass 2, 


IFB 


Blank 


IFDEF 


Defined 


IFDIF 


Different 


IFE 


"~f 

Zero 


IFG 


Positive 


IFGE 


Zero^ or positive 


IFIDN 


Identical 


IFL 


Negative 


IFLE 


Zero^ or negative 


IFN 


N on --zero 


IFNB 


Not blank 


IFNDEF 


Not defined 


INTERN 


Define internal symbols. 


lOWD 


Set up !/0 transfer word . 


IRP 


Indefinite repeat of macro arguments « 


LALL 


List all; expanded listing. 


LIST 


Implied at end of pass 2« 
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LIT 


A if 1 • J. ^1 

Assemble 1 iterals 


LOC 


Assign absolute addresses. 


NOSYM 


Suppress symbol table listing. 


OCT 


Input octal numbers. 


OPDEF 


Defines user-created operator. Generates o ' ■ word 


PAGE 


Skip to top of next page. 


PASS2 


Terminates pass 1 remaining statements are processed pass 


PHASE 


rol lowing coding reiocatea or execunon nme. 


POINT 


Sets up byte pointer word. 


PRINTX 


Prints when encountered during pass 1 . 


PURGE 


Purge symbols 


RADIX 


Sets prevailing radix to 2-10. 


RADIX50 


Compresses 36"*bit words, primarily for system use. 


RE LOC 


Implied tirst statement; assigns reiocaraDie aaaresses. 


REMARK 


Comments only statement. 


REPEAT 


Repeat n times 


RIM 


rrepore ouTput in t\im paper— rape lOimuT. 


RIMIO 


Absolute, unolocKea, output Tormai. ino cnt?c»^:>ufii5. 


RIMlOB 


MDSOiUTe, DIOCKeO, cneCKSUrrirntJU uuipul luisnui. 


SIXBIT 


Input text In compressed 6'~bi t ASCII ♦ 


STOPI 


Stop indefinite repeat of macro arguments. 


SUBTTL 


Subtitle on listing . 


SYN 


Make synonomous 


TITLE 


Title on listing . 


VAR 


Assemble variables suffixed with ^ . 


XALL 


Stop expanded listing. 


XLIST 


Stop listing . 


XWD 


Input two 18-bit half words . 


Z 


Input zero word. 
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SUMMARY OF CHARACTER INTERPRETATION 



The characters listed below have special meaning in the contexts indicated. These inter- 
pretations do not apply when these characters appear in text strings, or in comments. 



Character 



I 

& 

* 

/ 
+ 

1st character 
of text string 

B 

E 

0 



Meaning 

Colon . Immediately follows all labels. 

Semi-colon. Precedes all comments. 

Point, Has current value of the location 
counter . 

Comma . General operand or argument 
del imiter . 

Accumulator field delimiter 

References accumulator 0. The 
comma is optional . 

Delimits macro arguments . 

Inclusive OR 



AND 

Multiplication'^ 

Division 
Add 

Subtract 

J 



Logical Operators 



Arithmetic Operators 



In ASCII, ASCIZ and SIXBIT test strings, 
the first non-blank character is the 
delimiter . 

Follows number to be shifted and pre- 
cedes binary shift count. 

Exponent. Precedes decimal exponent 
in floating-point numbers , 

Parentheses, Use to enclose index fields, 

Enclose the byte size in BYTE 
statements . 

Enclose the dummy argument string 
in macro DEFINE statements. 



Example 

LABEL: Z 

;THIS IS A COMMENT 

JRST .+5 Jump forward five 
locations. 

DEC 10, 5, 6 
EXP A+B, C-D 

MOVE! 1, TAG 

MOVEI, TAG 

MACRO (A,B,C) 



ASCII/STRING/; 
7B2 

F22.1E5 Exponent is 5. 

ADD ACl, X(7) 
BYTE (6) 8, 8, 7 

DEFINE MAC (A,B,C) 
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Meaning 

Angle brackets. In an expression, enclose 
a numeric quantity. 

In conditional assembly statements, 
contain a single argument, and the 
conditional coding . 

In REPEAT statements, contain coding 
to be repeated . 

In macros, enclose the macro definition. 

Square brackets. Delimits literals. 

In OPDEF statement, contain new 
operator . 

Equal sign, direct assignment. 

Quotation marks enclose 7~bit ASCII 
text, from one to five characters. 

Number sign. Defines a symbol used as a 
tag. Variable. 

Apostrophe or single quote. Catenation 
character used only within macro 
definitions. 

Reverse slash. If used as the first char- 
acter in a macro call, the value of the 
following symbol is converted to on ASCII 
symbol in the current radix . 

Left arrow . Line continuation. 



Example 

<A-B+500/C> 

IFl <MOVE ACO, TAX> 

REPEAT 3, <SUB 17, TAG> 

DEFINE PUNCH 

< DAT AO PTP, PUNBUF (4)> 

ADD 5, [MOVEI 3, TAX] 
OPDEF CAL [MOVE] 

SYM=6 
SYM=A+B*D 

"ABCDE" 
ADD 3,TAG^ 

DEFINE MAC (A,B,C); 

< JUMP'A,B,C> 

MAC \A if A=500, this gen- 
erates three 7-bit ASCII 
characters. 
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FORTRAN IV COMPILER (F40) 



FUNCTION To compile source programs coded in FORTRAN IV 

^ programming language and produce machine language 

programs which are compatible with the Linking 
Loader and the Dynamic Debugging Technique pro- 
gram . 

• One-pass compiler 

• Accepts input from any input device 

• Includes features far in advance of ASA 
FORTRAN X3,9, 1966, requirements 



ENVIRONMENT 



Monitor 


All 


Minimum Core 


FORTRAN IV - (9K permits 4 continuation lines; lOK or 

more permits 1 9 continuation lines) 

FORTRAN IV Subset - 5.5K (4 continuation lines only) 


Additional Core 


Requests additional core from the Monitor when needed. 


Equipment Required 


One input device (source program input). 

Two output devices (if both machine language output and 
a listing are desired). 
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INITIALIZATION 



.R F40 core 
* 



Loads the FORTRAN IV Compiler into core. 

The FORTRAN IV Compiler is ready to accept a 
command . 



COMMANDS 



General Command Format 

ob jprog-dev: fi lename . ext, I ist-dev: fi lename . ext< 
objprog-dev: 



list-dev: 



source-dev: 



— source-dev:filename.ext, source-n ^ 

The device on which the machine language coding is 
to be written. Only one such file is produced, 

MTAn: (magnetic tape) 

DTAn: (DECtope) 

DSK: (disk) 

PTP: (paper tape punch) 

The device on which the compilation listing is to be 
wrhfen, Only one such file is produced . 

MTAn: (magnetic tope) 

DTAn: (DECtape) 

LPT: (I ine printer) 

DSK: (disk) 

TTY: (Teletype) 

The device(s) from which the source program(s) input 
to compilation is to be read , ^ 

MTAn: (magnetic tape) 

DTAn: (DECtape) 

TTY: (Teletype) 

CDR: (card reader) 

PTR: (paper tape reader) 



Note: Each source file may contain any number of source programs and need not contain an integral 
number of source programs as END OF FILE is ignored. However, statements may not be split between 
files. — 

2 . 

If this device is omitted, the last device named previous to it in the command string is assumed. 
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If more than one file is to be compiled from a mag- 
netic tape, cord reader, or paper tape reader, dev: 
is followed by a comma for each file beyond the first. 

If more than one file is to be compiled from DSK: or 
DTAn:, subsequent filename . ext's after the first are 
delimited by commas; dev: need not be repeated. 

Input via the Teletype is terminated by typing the 
END statement followed by a carriage return.' 

filenome.ext (DSK: and DTAn: only) The filename and filename extension of the object 

program file, the listing file, and the source file(s). 
If .ext Is omitted, .REL is assumed for the object file, 
. LST is assumed for the listing file, and . F4 Is as- 
sumed for the source file. 

The object program and listing devices are separated 
from the source devlce(s) by a left arrow. 



The project-programmer number assigned to the disk 
area to be searched for the source file(s)or in which 
the destination file is to be written if other than the 
user's project-programmer number. 

The standard protection^ is assigned to any disk file 
specified as output. 

Notes 

If object coding output is not desired (as in the case where a program is being scanned for source language 
errors), objprog-dev: is omitted . 

If a compilation listing Is not desired, list-dev: is omitted. 



Disk File Command Format 
DSKrfilename .ext[ proj, prog] 
[ pro j, prog]. 



Standard protection (055) designates that the owner is permitted to read or write, or change the protec- 
tion of, the file while others are permitted only to read the file. 



FORTRAN-3 



EXAMPLES 



• R F40^ 

*DSK:OBJPRO, LPT: < TTY: ^ 



-ft COMMON A,B,C,D^ Note 1 

-a DOUBLE PRECISION A,B,C,D(i 

-olTYPE lOji 

-OITYPE 20,A,B,C,D[i 

-rtCALL RESID (1 , 1 , 'P2222')ti 
10 -t5< FORMAT ('— PHASE!, MAIN--'/) ^ 
20 -Pi FORMAT (1 HO, D/) ^ 

-rtEND^ 

MAIN. ERRORS DETECTED: 0 

TOTAL ERRORS DETECTED: 0 
9K CORE USED 

*DTA3:TSTA, < — CDR:,,^ 

MAIN. ERRORS DETECTED: 0 
SUBl ERRORS DETECTED: 0 
SUB2 ERRORS DETECTED: 0 



Compile one source file from the Teletype; write the 
object code on the disk and assign the filename. ext 
OBJPRO.REL; write the compilation listing on the 
line printer. 



TOTAL ERRORS DETECTED: 
9K CORE USED 



0 



V Type in of source coding 



Compile three source program files from the card 
reader; write the object code on DTA3 and call the 

file TSTA.REL; produce no compilation listing, 

NOTE: This is not batch compilotion , There may be 
many source programs but only one object 
code file is produced* Assume there is one 
main program and two subroutines^ SUBl 
ond SUB2 , 



.KJOB 



Return to the Monitor* 

Kili the job^ deassign ail devices^ and release core, 



NOTE 1: The use of TAB ( — &| ) effectively positions the Teletype of column 7 of the FORTRAN Pro-^ 
gramming Coding Form (column 6 if o continuation Line)* TAB is typed by holding down the 
CTRL key at the same time the TAB key is depressed* 
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BATCH COMPILATION 



If several independent program files being compiled from the same input device require in- 
dependent listings on the same device, and require their (independent) machine language output on Ifie 
some device, the length of the command strings required for each compilation can be shortened by as- 
signing the three common devices before running the compiler. The command strings v^ill then consist 
only of the filenames of the source program files. As in the preceding section, each source file may 
contain several source programs but each file will be assumed to contain an integral number of programs. 
Example 

The files TESTA, TESTB, TESTC, and TESTD, all of v^hich reside on DTAl are to be compiled. 
File TESTA contains tv^o source programs. The object coding for each file is to be written on DTA2 and 
assigned the filenames of TESTA. REL, TESTB. REL, TESTC. REL, and TESTD. REL, respectively. 



.AS DTAl SRC ^ 

DEVICE DTAl ASSIGNED ^ 

.AS DTA2 BIN ^ 

DEVICE DTA2 ASSIGNED ^ 
.AS LPT LST ^ 

DEVICE LPT ASSIGNED^ 

'=TESTA,TESTB,TESTC,TESTD^ 
MAIN. ERRORS DETECTED: 0 
SUBA ERRORS DETECTED: 0 
SUBB ERRORS DETECTED: 0 
SUBC ERRORS DETECTED: 0 
SUBD ERRORS DETECTED: 0 

TOTAL ERRORS DETECTED: 0 
9K CORE USED 

•KJOB^ 



Assign DTAl as the common source device. 



Assign DTA2 as the common binary coding output 
device. 



Assign the line printer as the common listing output 
device. 



No devices need be specified in the command; the 
devices assigned are assumed . 

The object code from the two source programs In file 
TESTA will be written as file TESTA. REL on DTA2 
and so on for the other source files. ^Assume TESTA 
contains a main program and subroutine SUBA, 
TESTB, TESTC, TESTD each contain one subroutine. 



Return to the Monitor (or, if desired, more filenames 
could be specified for another compilation) . 



Vile TESTA. F4, TESTB. F4, etc. , ore assumed as the filenames and extensions of the source files; If 
TESTA, F4 cannot be found, filename TESTA Is searched for (some for TESTB, TESTC, TESTD). 
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SWITCHES 



Switches are used to specify such options as: 
1 . Magnetic tape control, 

2. Device directory manipulation, and 

3. Types of listings and message typeouts. 



All switches are either preceded by a slash or enclosed in parentheses. Switches C, E, M and N are 
complementary. 

Table FORTRAN-1 FORTRAN Switch Options 



Switch 


Meaning 


a1 

A' 


Advance magnetic tope leel by owe nie. 


J 
B 


^ i 5, * i ! ^ f f 


C 


Generate a CKEh-^rype cro5S™reterence nsnng. 

Complement: Do not produxe cross-reference information (standard procedure). 


e2 


Print an octal listing of the binary program produced by the compiler in addition to the 
symbolic iisting output. 

Complement: Do not produce octal listing (standard procedure). 




Elirrinate the macro coding from the output Hsting. 

Complement: Include macro coding in the output listing (standard procedure)* 


n2 


Complemet.t" Output error messages on TJV istGr'Oarc procedure), 


S 


if the compiler is running on the PDP--IO, produce code for execution on the PDP-6 and 
vice*-versa . 




Skip to the logical end of the magnetic tape reel. 




R e w ind t h e m ognetic *'''m^ • ^ ■ . 




Zero the DECtape directoi^y. 


NOTES: 1 . Must immediately follow the device name or filename. ext to which it applies. 

2. Standard listing procedures are - list error messages on the TTY and the source program with 
macro coding on the listing device. This is done unless a switch is used to override the 
standard listing. If the switch is complementary, a second occurrence of it in a command 
string means revert to standard listing procedures as described for the complement of the 
particular switch. A third occurrence of a switch acts as the first, and so on. 
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EXAMPLES 



.R F40^ 

*DTA2:/ZOBJTST,LPT:- 



■DSK:/EFORTAA[ 12,20] ^ 



20 FORMMAT (1 HO, D/) J 

1) SYNTAX 



Zero the directory on DTA2 and create 
a file called OBJTSI .REL as the binary 
object program file; compile the source 
file, FORTAA, located in area 12,20 
of the disk; produce a binary program 
listing (with octal code) as well as the 
regular source listing on the line printers. 
Assume FORTAA contains one main pro- 
gram . 

A syntax error has been detected in the 
source language. Such typeouts can be 
suppressed by use of the /"N switch. 



MAIN. ERRORS DETECTED: 1 

? TOTAL ERRORS DETECTED: 1 
9K CORE USED 

*DTA3: JOB1 , DSK: JOB1 <3 MTAl :/W, , ^ 

SUBl ERRORS DETECTED: 0 
SUB2 ERRORS DETECTED: 0 
SUBS ERRORS DETECTED: 0 

TOTAL ERRORS DETECTED: 0 
9K CORE USED 

.KJOB^ 



Create a new file called JOBl .REL on 
DTA3 as the binary object program file; 
create a file called JOBl . LST on the 
disk as the listing file; rewind MTAl , 
and compile the first three program files . 
Assume each contains one subroutine , 
SUBl, SUB2, SUBS. 

Return to the Monitor. 

Kill the job; deassign all devices, and 
release core . 
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DIAGNOSTIC MESSAGES 



After each source program is compiled the message 

"program-name" ERRORS DETECTED: n 
is printed where 

"program-name" is 1) MAIN, for a main program 

2) DAT. for a BLOCK DATA subroutine 

3) Subroutine-name for a subroutine 

and after all the files specified in the command string have been compiled, the messages 
TOTAL ERRORS DETECTED: m 
nK CORE USED 

are printed, where m is the total number of errors detected and is preceded by "?" if m>0, and n is 
the number of 1 K blocks required to compile the programs. 



Table FORTRAN-2 FORTRAN Diagnostic Messages 



Message 


Meaning 


7BINARY OUTPUT ERROR devifilename.ext 


An output error has occurred on the device spec- 
ified for the binary program output. 


7CANNOT FIND devifilename.ext 


Filename. ext cannot be found on this device. 


7INPUT DATA ERROR devifilename.ext 


A read error has occurred on the source device. 


?x IS A BAD SWITCH 


The specified switch is not recognizable. 


?x IS AN ILLEGAL CHARACTER 


A character in a command string typein is not 
recognizable (e.g., FORM-FEED). 


? dev: IS NOT AVAILABLE 


Either the device does not exist or it has been 
assigned to another job. 


7LISTING OUTPUT ERROR devifilename.ext 


An output error has occurred on the device spec- 
ified for the binary program output. 


?NO ROOM FOR dev:filename.ext 


The directory on devi DTAn is full and cannot ac- 
cept filename. ext as a new file, or a protection 
failure occurred for a DSK output file. 


9SYNTAX ERROR IN COMMAND STRING 


A syntax error has been detected in a command 
string typein (e.g., the <3 — has been omitted). 


7INSUFFICIENT CORE - COMPILATION 
TERMINATED 


The compiler has insufficient table space to com- 
pile the program. 
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SMALL FORTRAN IV COMPILER 



The instructions below apply l-o the small FORTRAN IV (F40S) Compiler, which handles a subset of the 
standard FORTRAN IV Compiler (F40). 



INITIALIZATION 



Logical Assignments (see "Batch Compilation") 



.R F40S^ 



Loads the small FORTRAN IV Compiler into core. 
The Compiler Is ready to accept a command. 



COMMANDS 



1 . Logical assignments must be made as shown for batch compilation (page FORTRAN-5). 

2. The command string can contain many source files but each source file is assumed to contain only 
one source program. Every source file on a directory device must have the extension ".F4" as this 
is assumed by the compiler. The command string, then, consists of filenames only. 

3. One binary output file and one listing file are produced if logical assignments have been made for 
them . 

4. If no listing device is specified, a source code error produces "?E" on the user's Teletype. Com- 
pilation of that file is terminated. 

5. No switches are allowed . 
Example: 



• AS DTA2 SRC 

DEVICE DTA2 ASSIGNED^ 

• AS DTA3 BIN^ 
DEVICE DTA3 ASSIGNED^ 

.R F40S^ 
""FILA, FILB^ 



Assign DT - ■ . 

Assign DTA3 as the binary output device. 

Run the small compiler 

Compile fib FILA.F4 and FrLB*F4, the object code 
for FILA.F4 will be written as file FILA.REL (and 
FILB.F4 as FILB.REL) on DTA3. 

Return to Monitor (or, if desired^ more files can be 
compiled) » 
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LINKING LOADER (LOADER) 



FUNCTION 



To load and link relocatable binary (.REL) programs 
generated by Macro- 10 or FORTRAN IV preparatory 
to execution. Generates a symbol table in core for 
execution under the Dynamic Debugging Technique 
program . 

• Provides automatic loading and relocation of 
Macro- and FORTRAN-generated binary programs 

• Produces an optional storage map 

• Storage used by the Linking Loader is recoverable 
after loading 

• Performs loading and library searching regardless 
of the input medium 



ENVIRONMENT 



Monitor 


All 


Minimum Core 


2K 


Additional Core 


Automatically requests additional core from the Monitor as required. 


Equipment 
Required 


User Teletype for control; one or more input devices for binary pro- 
grams to be loaded; output device for loader map (optional); one 
systems device containing library files (optional). 
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INITIALIZATION 



.R LOADER core^ Loads the Linking Loader into core* Core 

allocated equals 2K plus core required 

by binary programs; "core^* is opfimaL 

* Indicates that the program is ready to 

receive a command. 



COMMANDS 



General Command Format 



list-dev:filename .ext< — source-devl ifilename .ext,dev2: . . . .source-n( ALTMODE) 



list-dev: 



Ice on which any storage maps or undefined 
are to be written . 

LPT: (fine printer) 

TTY: (Teletype) 

DTAn: (DECtape) 

DSK: (disk) 

MTAn: (magnetic tape) 

If iiiu iUiorype is to be assumed as the output 
devi'"^-" f"'*"- 

list -dev:filename .ext<— 



source-dev: 



The device(s) from which the binary relocatable 
pron-'-'-'i--- -re to be loaded* 

DSK: (disk) 

DTAn: (DECtape) . 

MTAn: (magnetic tape) 

PTR: (paper tope reader) 

If more than one file is to be loaded from a mag-- 
netic tape^ cord reader^ or paper tape reader^ 
dev: IS followed by a comma (or the device noma 
or : can be repeated) for each file after the first. 



filename. ext (DSK: and DTAn: only) 



The filename. ext of each reiocatable binary file to 
be loaded* If *ext is omitted^ it Is assumed to be 
.REL. If o search for filename « RE L is unsuccessful, 
a second search for the same filenome with the null 
extension is performed ♦ 

The filename *ext of the output listing file* If *ext 
is omitted, .MAP is used . 
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The storage map device is separated from the source 
device(s) by the left arrow symbol . 



Notes 

1 . Each time RETURN ) is typed, loading is performed for all files listed on that line. 

2. Each time ALTMODE is typed, all remaining loading, library searches, and output operations are 
completed, and an exit is made to the monitor. 

3. The source device, once stated, continues as the source device until a new source device or 
destination device is specified, or until ALTMODE is typed. 

4. Files are loaded in the order they appear in the command string. The file requiring the largest 
COMMON area must be specified first in any loading operation. 

5. When loading is terminated (by ALTMODE or switches /C, /G, or /R), the following steps are 
executed . 

a. A FORTRAN library search is performed if any undefined globals remain (unless prevented by 
the /P switch). 

b. If undefined globals still remain, they are listed on the Teletype or other specified listing 
device . 

c. The number of multiply defined globals (if any) and the number of undefined globals (if any) 
are printed on both the Teletype and on the specified listing device (if given). 

d. A Chain file, if requested, is written. 

e. The loaded program is relocated down to the actual locations into which it is to be loaded. 

f . The message 

LOADER 
EXIT 

is printed on the Teletype. 



Save and Execute Commands 

After loading is completed, to write the loaded program onto an output device so that it can be exe- 
cuted at some future date without rerunning Linking Loader: 

LOADER^ Loading is completed * 

Exnp Automatic exit to the Monitor. 
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SAVE dev:filename .ext core^ 



JOB SAVEDJ 



START^ 



EXIT^ 



V/rite out f-he user^s area of core onto 
the specified output device ond^ if 
the device is DTAn: or DSK: , assign 
it the specified filename .ext. If .ext 
is omitted, .SAV is assumed. 

The value for core may be given when 
the user wishes to run the program in 
more core than it will be saved in; this 
might be done to gain more space for 
dynamic allocation of buffers. 



"'1 pie ted 



pre 

to the ^ 

Start e. 

Return 



User's program execute 

' - '^'^Wc return is maoe 
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EXAMPLES 

. R LOADER 5^ 

*DSK:MARK1 ,MARK3,p TA3:SUBRTE ^ 
* C ALC , PTR: (ALTMODE) ^ 



L 

of core . 

L lesMARKI 

. , .REL files 
..; , JTA3, and 
one .REL file from the paper tape 
reader. 



LOADER ^ 
EXIT^ 

.SAVE DSK MARKET^ 



JOB SAVED^ 

. STARTS 
EXIT^ 



Link-loading is completed; and auto- 
matic return is made to the Monitor. 



Write out the user's program as an 
executable program on the disk and 
call the file MARKET. DMP. Core as- 
signed to the user remains unchanged . 

NOTE: Saving a job is optional . 

Save process is completed; an auto- 
matic return is made to the Monitor. 



Begin execution of job. 
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SWITCHES 



Switches are used to: 

1 . Specify the types of symbols to be loaded or listed, 

2. Set the library search mode, 

3. Load the Dynamic Debugging Technique (DDT) program, and 

4. Clear and restart Linking Loader. 

All switches are either preceded by a slash (/) or enclosed in parentheses. 



Table LOADER-1 Linking Loader Switch Options 



Switch 


1 Meaning 


Complement Switch 


A 


List all global symbols in storage map regardless of progrom 
length. 


® 


nnnnnC 


Create Chain file; use first block data for program break; 
nnnnn (if nonzero) Is starting address , Terminate Linking 

Loader. 




D 


Load UUI; enter load witn syrribols: 
mode (S); turn off library search 
mode (N). 

Terminates specification. 




E 


Upon termination of loading, control will be transferred tc 
user's program starting address (starting address of last program 
loaded) . 




F 


Perform a library search of LIB40; exit from "load with symbols 
mode . 

Terminates specification. 




nnnnnG 


Perform an automatic search of LIB40 if any undefined globals 
remain (unless the /P switch is used); list any still -undefined 
globals; set the starting address of the program as nnnnn; exit 
to the Monitor. Use ALTMODE, instead, if starting address to 
be used is the one originally specified 




I 


Set the loader to ignore the starting addresses in binary input. 


® 


® 


Set the loader to accept the starting address of this binary input 
program . 


I 


L 


Enter the i iuu. ;,,oou 


(B) 


NOTE: Q indicates those switches set when loader is in its initial state. 
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Table LOADER-1 (Cont) Linking Loader Switch Options 



Switch 


Meaning 


Complement Switch 


M 


Print the storage map and undefined globals. Terminate speci- 
fication* 






Turn off the library search mode. 




nnnnnO 


Load beginning at numeric argument (octal) if nonzero. 




P 


Prevent an automatic library search* 


(§) 


(§) 


Allow an automatic library search , Turn off the "load with 
local symbols" switch. 


p 


nnnnnR 


Create Cham file; use first rUKTRAN IV program break; nnnnn 
(if nonzero) is starting address. Terminate Linking Loader . 






Load with local symbols. 


@) 


T 


Loads bYb:L/L/l .KfcL; turns on lood wirn lOcai :>ymDOis \o) swsrcri, 
upon termination of loading transfers control to DDT for program 
testing . 




U 


List undefined global symbols on the output list device. 
Terminates specification « 






Load without local symbols. 


S 


® 


Suppress listing of global symbols for zero-length programs. 


A 


Y 


Rewind magnetic tape before use 




Z 


Clear user's core area; reset the loader to its initial state; 
restore the Teletype; restart loading. Terminates line. 




NOTE ( 


3 indicates those switches set when loader is in its initial state. 



The effect of a switch on adjacently named files in the command string depends upon whether 
the switch is a status switch or an action switch. 



Status Switches (A, I, J, L, N, O, P, Q, S, W, X) set the loader to a particular status and have an 
effect on the file in whose specification it appears and on any subsequently name files 
in the command string (unless the switch is reset), A file specification is terminated 
and processed whenever a comma, or a colon (if the previous delimiter was a colon), 
a RETURN, or ALTMODE is encountered. 

*DTA5:RESID/S,/M Local symbols ore loaded for this and any following 

files. A storage map is printed for this file . 

*DTA5:RESID,/M/S A storage map is printed for this file; however, 

local symbols are not loaded for this file since the 
/S switch appears outside the file specification 
(which is terminated by the comma) . Local symbols 
are loaded for any following files. 
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*DTA5:RESID,/S 



Loco! symbols are not loaded for this file since the 
/S switch appears outside the file specification 
(which IS terminated by the comma). 



Action Switches (C, D, E, F, G, M, R, T, U, Y) request an immediate or file-independent action to be 

performed by the Loader and are not directly related to any specific file specification(s). 

Chain Feature 

The Chain feature is used to segment FORTRAN programs which are too large to be loaded into core as 
one unit. When switch /C or /R is specified, loading is terminated and a file acceptable to the Chain 
program is written. 

Examples: *DSK:CHNPRG < — /R or *DTA1:SEGF4< /Q 

If .ext is omitted for the output Chain filename, .CHN is used. 

The Chain file contains: 

1 . The contents to be loaded into JOBDDT, JOBSA, JOBFF, and JOBSYM. 

2. The data, beginning from the Chain address through the top of the core area used in loading. 

The Chain address is set from JOBCHN as loaded; switch /C specifies the right half and switch /R 
specifies the left half. Location JOBCHN Is loaded as follows: (1) the right half contains the program 
breakofthe first FORTRAN IVBLOCKDATAprogrom; (2) the left half contains the program break of the 
first FORTRAN IV program. If switch/C or/R contains a nonzero numeric argument, this becomes the 
starting address of the loaded program. After the Chain file has been written correctly, the messages 
below are output to the Teletype. 

CHAIN^ 
EXIT^ 
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EXAMPLES 



.R LOADER 6^ 

*DTA5:RESID,SUBl,SUB2,DTA3:COMPLX^ 



7000001 UNDEFINED GLOBALS^ 
? SUB4A 000153^ 



*DTA5:SUB4^ 



*LPT:/M<- 
LOADER^ 

.KJOB^ 



(ALTMODE) ^^ 



Run Linking Loader and assign it 6K 
of core. 

Load and link binary program files 
RESID.REL, SUBKREL, and SUB2.REL 
from DTA5, and the file COMPLX.REL, 
DTA3. 

Carriage return initiates loading. 

Force a premature search of LIB40 to 
resolve any undefined globals up to 
this point. 

List on the Teletype (since no output 
device v^as specified in the first com- 
mand line) all globals which are still 
undefined . 

Undefined global and location con- 
taining instruction which calls it are 
listed . 

Knowing that the undefined global is 
' in the binary program file SUB4, the 
user requests that it be loaded also. 

Check if undefined global has now 
been resolved ♦ 

All globals are defined; print storage 
map on the line printer and exit to 
the Monitor. 



Kill the job, deassign all devices, 
and release core. 
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I DIAGNOSTIC MESSAGES 



Table LOADER-2 Linking Loader Diagnostic Messages 



Message 


■ ▼ 'V^ \A% 1 1 1 1 y 


9CANNOT FIND filename. ext 


The filename. ext specified Is not In the file direc- 
tory. If no .ext Is specified for a file, the file Is 
first searched for with the name filename .RE L, and 
if not found. Is then searched for under the null 
filename extension. 


7CHAIN DEV ERROR 


A device error has occurred while writing the 
Chain file. Chain file is terminated. 


?x CHAR. ERROR IN LOADER COMMAND 


An Illegal character was entered in a command 
string . 


?DIR. FULL 


The file directory of the specified list device Is full 
and cannot contain an additional file, or a null file 
name was specified. 


EXIT 


If this message appears at the beginning of the 
run, either insufficient core has been assigned for 
loading or no console is attached to the job. 
EXIT normally is typed at the end of the loading 
process (after ALTMODE or /G) before exiting to 
the monitor. 


?ILL. COMMON filename. ext 


A file other than the first contains a program which 
has attempted to expand the already established 
COMMON area. This program must be loaded 
first. 


?ILL. FORMAT filename. ext 


The input source file is in proper checksummed 
binary format, but not in proper link format. 


rINPUT ERROR filename. ext 


A read error has occurred on an input source de- 
vice. Use of that device Is terminated. 


?symbol ignored-value old-value 
MUL.DEF. GLOBAL filename. ext 


A global symbol definition having a value different 
from that of a previous definition of the same sym- 
bol has been encountered. The new value is 
ignored and the symbol appears in the symbol table 
only once. 


?NO CHAIN DEVICE 


No device has been specified for the Chain file. 
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Table LOADER-2 (Cont) Linking Loader DiagnosHc Messages 



Message 


Meaning 


?x SWITCH ERROR IN LOADER COMMAND 


An improper switch designation has been entered 
in a command string . 


?x SYNTAX ERROR IN LOADER COMMAND 


A syntax error has been encountered in a command 
string . 


?dev: UNAVAILABLE 


Either the device does not exist or it is assigned 
to another job. 


7UNCHAINABLE AS LOADED 


The Chain address (the half of JOBCHN selected 
by /C or /R) is zero. 


?nnnnnn UNDEFINED GLOBALS 


nnnnnn undefined globals were found. 


? SYMBOL TABLE OVERLAP file.ext 
?nnnnnn WORDS OF OVERLAP file.ext 


nnnnnn additional words (octal) are required to 
load everything requested in the last command 
string line. 
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FORTRAN LIBRARY 

• FORTRAN OPERATING SYSTEM (FORSE.) 

• SCIENTIFIC SUBROUTINES 



FUNCTION 



The FORTRAN Library (LIB40) contains the FORTRAN 
Operating System (FORSE.) and its subroutines, as 
well as the Scientific Subroutine Library. Some of 
these library routines are always required by 
FORTRAN-compiled programs at run time. 

The FORTRAN Operating System performs two major 
functions: (1) all I/O operations and format con- 
versions, and (2) error checking and output of error 
messages on the Teletype. 



COMPILATION TIME 



At compilation time, the FORTRAN compiler generates user UUO's in the range of GO through 37g to 
communicate the necessary I/O requests to FORSE. These UUO's are interpreted at run time by FORSE. 
which in turn executes Monitor UUO's (40 through 77^ to perform the actual I/O operations called for. 



LOADING TIME 



The loading of the appropriate subroutines from the FORTRAN Library is performed for each FORTRAN- 
compiled program by the Linking Loader. When loading is terminated, an automatic search of the 
FORTRAN Library file (LIB40) is performed for any programs referred to by the FORTRAN-compiled pro- 
gram but not explicitly loaded previously by the user. As a result of this search, FORSE., its related 
subroutines, and any required Scientific Library subroutines are loaded. 
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Job Data Area 



Dynamic Debugging Technique - DDT (if loaded) 



FORTRAN Main Program 
(User's Coding). 



LIB40 Routines: 

- FORTRAN Operating System (FORSE.) 

- Scientific Library, etc. 



I/O Buffers 



Unused Area 

(May be used for I/O buffers 
if there are many devices) 



Symbol Table 



User's relative 



address 140, 



8 



Last location 
of user area 



Figure LIB40-1 Core Storage Map of DDT, 
FORTRAN Main Program, and LIB40 
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DIAGNOSTIC MESSAGES 



Table LIB40-1 FORTRAN Operating System Diagnostic Messages 



Message 


Meaning 


? DEVICE dev: NOT AVAILABLE 


PijRnP triorl inifrlnliTO n rlov/Ir*^ XA/nir^M oi4'i^or 
f r\ J im • iiicvj \\J iiiiiiuii^c u ucviv^c wiiicii diiid 

does not exist or has been assigned to another job. 


? DEVICE NUMBER n IS ILLEGAL 


A nonexistent device number was selected. 


? DOUBLE PRECISION OVER OR UNDERFLOW 


An overflow or underflow error occurred while 
UUU I HQ f suDrracTmg^ muiTipiyiny/ or aiviuing two 
double-precision numbers. 


?END OF FILE ON dev: 


A premature end of file has occurred on an input 
device . 


?END OF TAPE ON dev: 


The end of tape marker has been sensed during 
input or output. 


?FILE NAME filename. ext NOT ON 
DEVICE dev: 


Filename. ext cannot be found in the directory of 
the specified device. 


7ILLEGAL CHARACTER, x, IN FORMAT 


The illegal character x is not valid for a FORMAT 
statement. 


7ILLEGAL CHARACTER, x, IN 
INPUT STRING 


The illeaal character x is not valid for this tvoe 
of input. 


? ILLEGAL MAGNETIC TAPE OPERATION, 
TAPE dev: 


An attempt was made to skip a record after per- 
forming output on a magnetic tape. 


7ILLEGAL PHYSICAL RECORD COUNT, 
TAPE dev: 


FORSE. has encountered an inconsistency in the 
physical record count on a magnetic tape. 


7ILLEGAL USER UUO uuu AT USER loc 


An illegal user UUO to FORSE. was encountered 
at location loc . 


7INPUT DEVICE ERROR ON dev: 


A data transmission error has been detected in the 
input from a device. 


?MORE THAN 15 DEVICES REQUESTED 


Too many devices have been requested. 


7NAMELIST SYNTAX ERROR 


Improper mode of I/O (octal or Hollerith), in- 
correct variable name. 


? NO ROOM FOR FILE filename. ext 
ON DEVICE dev: 


There is no room for the file in the directory of 
the named device. 
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Table LIB40-1 (cont.) FORTRAN Operating System Diagnostic Messages 





Meani ng 


programname NOT LOADED 


A dummy routine was loaded instead of the real 
one. Generally, this error occurs when a loaded 
program is patched to include a call to a library 
program which was not called by the original pro- 
gram at load time. 


70UTPUT DEVICE ERROR ON dev: 


A data transmission error has been detected during 
output to a device. 


? PARITY ERROR ON dev: 


A parity error has been detected. 


? REREAD EXECUTED BEFORE FIRST READ 


A 1 II lilr ••■•I** il 

A reread was attempted betore initializing the 
first input device. 


?TAPE RECORD TOO SHORT ON UNIT n 


The data list is too long on a binary tape read 
operation . 


?dev: WRITE PROTECTED 


The device is write locked. 


NOTE: With the exception of the messages "DOUBLE PRECISION OVER OF UNDERFLOW" and 
"ILLEGAL USER UUO uuu AT USER loc," all messages are followed by a second message 

?LAST FORTRAN I/O AT USER LOC adr 
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JOB DATA AREA (JOBDAT) 



This area provides storage for items of interest to both 
the Monitor and the user. The job data area is auto- 
matically allocated space just prior to the core area 
occupied by the program coding. The area occupies 
96^ Q 040q) locations. 

JOBDAT exists in binary form in the Systems Library 
for loading with user programs which refer to JOBDAT 
locations symbolically. JOBDAT is loaded auto- 
matically, if needed, during the Loader's library 
search. 



Table JOBDAT-1 Job Data Area Locations 



Name 


Relative 
Location(s) 
Octal Decimal 


Description 


JOBUUO 


40 


32 


User's location 4O3. Used for processing user UUO's (001 through 
037). 


JOB41 


41 


33 


User's location 41g. Contains the beginning address of the user's 
programmed operator service routine. 


JOBREL 


44 


36 


Left half: 0 

Right half: The highest relative core location available to the user 
(i.e., the contents of the memory protection register when this 
user is running). 


JOBDDT 


74 


60 


Contains the starting address of DDT. If contents are 0, DDT has 
not been loaded. 


JOBSYM 


116 


78 


Contains a pointer to the symbol table created by Linking Loader. 
Left half: Negative count of the length of the symbol table. 
Right half: Lowest register used. 


JOBSA 


120 


80 


Left half: First free location in user area (set by Loader). 
Right half: Starting address of the user's program. 


JOBFF 


121 


81 


Left half: 0 

Right half: Address of the first free location following the user's 
program. Set to C(JOBSA)l^ by RESET UUO. 
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I FUNCTION 



Table JOBDAT-1 (Conf) Job Data Area Locations 



Name 


Relative 
Location (s) 
Octal Decimal 


Description 


JOBREN 




124 


84 


Set by user and used by REENTER command as an alternate entry 
point. 


JOBAPR 




125 


85 


Lett nait: u 

Right half: Set by user program to trap address when user is en- 
abled to handle APR traps such as illegal memory, pushdown over- 
flow, arithmetic overflow, and clock. See CALL APRENB UUO. 


JOBCNI 




126 


86 


Contains state of APR as stored by CONI APR when a user-enabled 

A DO 1. 

APR trap occurs • 


JOBTPC 




127 


87 


Monitor stores PC of next instruction to be executed when a user- 
enabled APR trap occurs. 


JOBOPC 




130 


88 


The previous contents of the user's program counter are stored here 
by Monitor upon execution of a DDT, REENTER, START, or 
CSTART command. 


JOBCHN 


131 


89 


Left half: 0 










Right half: Address of first location after first FORTRAN IV Block 
Data, 


NOTE: 


Only those JOBDAT locations of significant importance to the user are given in this table. 
JOBDAT locations not listed include those which are used by the Monitor and those which 
are unused at the present time. User programs should not refer to any locations not listed 
above since such locations are subject to change without notice. 
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FILE UPDATE GENERATOR (FUDGE2) 



To update files containing one or more relocatable 
binary programs. 

• Permits user to manipulate individual programs 
within program files 



ENVIRONMENT 



Monitor 


All 


Minimum Core 


2K 


Additional Core 


Dynamically allocates its buffers to utilize as much core as 
is made available. 


Equipment 
Required 


Two input devices, one for the master file and one for the 
transaction file; one output device for the updated file. 
The input device{s) and output device can be the same de- 
vice (DSK:).The two input devices can be the same DECtape . 
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INITIALIZATION 



.R FUDGE2^ i^^^^ ^1^^ p.,g Update Generotor 

program . 

FUDGE2 is ready to receive a 
command , 



I COMMANDS 



General Command Format 



new-dev:filename.ext<3 master-dev:fllename .ext<prognamel ,progname2, . . prognamen>, 

transaction-dev:filename.ext<prognamea,prognameb, . . . prognamez > (commands) (ALTMODE} 



new-dev: 



master-dev: 



transaction-dev: 



The destination device, on which the updated 

DTAn: (DECtape) 

DSK: (disk) 

MTAn: (magnetic tape) 

PTP: (paper tape punch) 

The device containing the file to be updated* 

DTAn: (DEC tope) 

DSK: (disk) 

MTAn: (magnetic tape) 

PTR: (paper tape reader) 

NOTE: If more than one file is to be transferred 
from a magnetic tope or paper tope 
reader, dev: is followed by a colon (:) 
for each file after the first. 

The device containing the fi!e of programs to be 
used in the updating process* 

DTAn: (DECtope) 
DSK: (disk) 
MTAn: (mognetic tape) 

(paper tape reader) 



PTR: 



NOTE: If more than one file is to be transferred 
from a magnetic tape or paper tape 
reader, dev: is followed by a colon (:) 
for eoch fiie after the first. 
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More than one transaction device, with its associated 
filenames and program names, con be specified in 
certain instances (see "Switches") • 



filename. ext (DSK: and DTAn: only) 



The filename. ext of the new, updated version of 
the program file . 

The filename. ext of the program file containing 

the programs to be deleted, replaced, or augmented. 

The filename. ext of the program file containing 
the programs to be used in performing additions or 
replacements to the master file. 

If no .ext is given, .REL Is assumed. 



<progname, >(DSK: and DTAn: only) 



Program names must be specified in the same 
relative order in which they appear in the file. 

Program names ore grouped together within angle 
brackets < > and are separated by commas. 

If It is desired to append, replace, insert, or 
extract all programs within a file, only the 
filename. ext need be specified. 

Program names cannot be specified for the output 
file. 

The new output file is separated from the master 

and transaction files by the left arrow symbol (<i ), 



Command Codes 



The function to be performed by FUDGE2 is selected by including one of the following command codes 
at the end of the command string. Command codes are enclosed within parentheses (or preceded by a 
slash) and one (and only one) must appear in every command string. 



Table FUDGE-1 FUDGE2 Command Codes 



Command 



Meaning 



Append one or more programs from the transaction fiie(s) to the master file and write 
out the new file. The command string is as follows: 



new 



-f I le <3 — master-f I le , transoc tion-f i le , (A) (ALTMOPQ 
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Table FUDGE-1 (Cont) FUDGE2 Command Codes 



Command 


Meaning 


D 


Delete one or more programs from the master file and write out the new file. The files 
(and programs) to be deleted are listed after master-dev: . The command string Is as 
follows: 

new-file< — master-file<fne(s) to be deleted>(D) (ALTMODE^ 


E 


Extract the specified files (and programs) from one or more input files and create a new 
output file. If program names are not specified for a file, the entire file is extracted. 

The command string is as follows: 

new-file < — masterfile<file(s) to be extracted>(E) (ALTMODE) 


I 


Insert programs from one or more transaction files onto the master file and write out the 
new fib. The programs from the transaction file(s) are inserted immediately before the 
specified programs on the master file. The command string is as follows: 

new-file<— master-file<fi le(s)to be inserted before>, transaction-file(s) (I)CALTMODE) 


L 


List all relocatable programs within a file and print the listing on the output device, 
which must be either TTY: or LPT: The command string is as follows: 

listing-device<l file(L)(ALTMODS 


R 


Replace the named program (s) on the master file with the named program(s) from the 
transaction file and write out the new file. The command string is as follows: 

new-file < — ■ master-file<fl le(s) to be replaced >,tran5;arHon-f;ip<'r^plnr^m^nt frloMs 

(R) Cmtmode) 



NOTE: Only one operation can be specified per command string. Thus, to delete a file and replace 
some other one, two command strings are required. 
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EXAMPLES 



.R FUDGE2^ 

* LPT: < DTAl •.LIB40(L) CmjMODE) J 



*DTA2:LIB4AA< — DTAl:LIB40<EXP.2>(D)(SjMOD£g 

*DSK:LIB4BB«a DTA2:LIB4AA<EXP.3>DTA1 :F1^ 

< FX P ■ 3A ■ FXP . 3B>DTA3: EXP NT(R) (ALTMODE) ^ 



List all relocatable programs (.REL) 
from the file LIB40, located on 
DTAl on the line printer. 

Delete the program EXP. 2 from the 
file LIB40 on DTAl; write the new 
file on DTA2 and call it LIB4AA.REL. 

Replace program EXP. 3, located in 
file LIB4AA on DTA2, with programs 
EXP.3A and EXP.3B in file Fl on 
DTAl and with all the programs in 
file EXPNT on DTA3; write out the 
new LIB4AA file on disk and call it 
LIB4BB. 



^PTP: 



.KJOB^ 



■DSK:LIB4BB,DTA4:SCIENC<C0SRTE>/A(ALTM0DI3 Append the program COSRTE, located 

in file SCIENC on DTA4, to the file 
LIB4BB on disk; write out the updated 
LIB4BB file on the paper tape punch . 

Return to the Monitor ♦ 

Kill the job, deassign all devices, 
and release core . 
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I SWITCHES 



Switches are used to manipulate file directories and to position magnetic tape. They are either preceded 
by a slash or enclosed in parentheses and can appear anywhere in the command string. 



Table FUDGE-2 FUDGE2 Switch Options 


Switch 


Meaning 


B 


backspace magnetic rape one file. 


K 


Advance magnetic rape one file. 


W 


Rewind magnetic tope « 


z 


Clear directory of destination device (DTAn: only) . 



I EXAMPLES 



Clear the directory of DTA2; rewind 
MTA1 and advance the tope one file; 
append the first two program files 
from MTA2 to the second file on MTAl 
and write out the resultant file on 
disk/ calling it TESTA« 

Return to the Monitor. 

KiH the job,, deassign all devices^ 
and release core« 



.R FUDGE2^ 

' DTA2:TESTA<3 MTAl : (WK) , MTA2: : (ZA) (ALTMODE) j 



.KJOB^ 
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( 



DIAGNOSTIC MESSAGES 



Table FUDGE-3 FUDGE2 Diagnostic Messages 



Message 


Meaning 


7CANNOT DO I/O AS REQUESTED 


Input cannot be performed on one of the devices 
specified for input (it is an output only device) or 
output cannot be performed on the device specified 
for output. 


7DEVICE ERROR ON OUTPUT DEVICE 


A write error has occurred on the output file . 


7DIRECTORY FULL ON OUTPUT DEVICE 


No more files can be added to the file directory on 
the output device (the directory is full). 


? ENTRY BLOCK TOO LARGE, 
PROGRAM xxxxxx 


The entry block of program xxxxxx is too large for 
the FUDGE2 entry table, which allows for 32 entry 
names. FUDGE2 can be reassembled with a larger 
table. 


? FUDGE SYNTAX ERROR 


The command string is illegal (e.g., the left arrow 
was omitted, a program name was specified for the 
output file, or some meaningless command was 
entered) . 


?x IS AN ILLEGAL CHARACTER 


An illegal character has been encountered in the 
command string . 


?x IS AN ILLEGAL SWITCH 


An illegal or otherwise meaningless switch has been 
encountered in the command string. 


?dev NOT AVAILABLE 


The device either does not exist or has been as- 
signed to another job. 


?NOT ENOUGH ARGUMENTS 


An insufficient number of files of one type or an- 
other has been specified. 


?dev fi lename .ext progname NOT FOUND 


Either the filename. ext or the program name was 
not found on the device (or in the tilej specitied. 
If a program name is printed, this may indicate that 
the program names in the command string appear in 
a sequence different from their sequence within the 
file; thus, the program may actually exist in the 
named file but was missed because of the incorrectly 
entered sequence in the command string. 


? PROGRAM ERROR WHILE RESETTING 
MASTER DEVICE 


Either FUDGE2 cannot find the master device or 
cannot find the program name on the master device. 
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Table FUDGE-3 (cont.) FUDGE2 Diagnostic Messages 



Message 


Meaning 


?TOO MANY FILE NAMES OR 
PROGRAM NAMES 


More than 40 program names or file names were 
given in a command string. Break the job into 
several segments and rerun. 


? TRANSMISSION ERROR ON 
INPUT DEVICE dev 


A transmission error has occurred while reading data 
from device dev. 


7UNEQUAL NUMBER OF MASTER 
AND TRANSACTION PROGRAMS 


An unequal number of master and transaction pro- 
grams (or files) has been specified with a Replace 
request. 
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DYNAMIC DEBUGGING TECHNIQUE (DDT) 



FUNCTION 



To provide a powerful, easy-to-use on-line debug- 
ging system. 

• Monitors the status of a running program 

• Enables the user to modify program instructions 
at any point during run time 

• User may stop program at predetermined points 
(breakpoints) 

• Can be used to create and execute a program 

• Performs "effective address" searches to obtain 
all references to a given core location 

• Input/output can be in symbolic, numeric, and 
test modes 



I ENVIRONMENT 



Monitor 


All 


Minimum Core 


2K 


Additional Core 


Not used. 


Equipment Required 


Only the equipment required by the program being 
debugged, plus a Teletype. 
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INITIALIZATION 



DDT IS loaded with the user's program to be debugged during the Linking Loader phase. Loading of 
DDT IS requested by use of the /□ switch , Control is transferred to DDT by typing 

.DDT^ 

at the monitor level « Thus, o typical initiai izatlon sequence might be 

,R LOADER 5^ 

*/D devifilename.ext, 

*DTA5:TEST^ 
-^ (ALTMODE) 

LOADER^ Program to be debugged and DDT (along 

with the symbol table) is loaded in core . 




Transfer con ho I to DDT, 

Two carriage returns indicate that DDT is 

ready to acgept commands « 



Start execution of the user's program under 
control of DDT, If the user desires to 
start execution at other than the previously 
defined starting address (JOBSA), he can 
type adrSG^, 



NOTE: DDT is initialized to 

I « Interpret numbers in octal radix ^ and 

2, Output addresses in the symbolic mode, relotive to symbolic labels. 
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COMMONLY USED COMMANDS 



NOTE: In general, commands can be entered be- 
fore the program execution is started or 
during a breakpoint halt. 



To Set a Breakpoint 

Up to eight breakpoints can be set at any one time. 

adr$B Set a breakpoint (the number of the breakpoint is 

assigned, usually in a sequential manner, by DDT) 
af odr (symbolic or absolute.) When the breakpoint 
is reached, the program halts and types out 

SnB»adr 

adr$nB Set breakpoint ^n at adr (symbolic or absolute). 

When the breakpoint is reached, the program halts 
and types out 

$nB»adr 

adr (loc)$nB Set breakpoint at adr (symbolic or absolute) . 

When the breakpoint is reached, the program halts 
and types out 

$nB»adr 

fol lowed by 

loc/ contents of loc 

The address loc is now open for modification by the 
user. 

adr (loc)$$nB Same as above, except that only the contents of loc 

are typed out and the program proceeds automati- 
cally . 

NOTES : 1 « The $ symbol can be entered with the ALTMODE key . 

2 . Breakpoints cannot be set on instructions which ore: (1) modified by the program; (2) 
used as data or literals; (3) used as port of an indirect addressing chain; or (4) the user- 
mode Monitor command INIT . 
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To Proceed From a Breakpoint Holt 



$P 
n$P 

To Remove a Breakpoint 
0$nB 

$B 



Resume program execution. Halt again next time the 
breakpoint is reached. 

Resume progrom execution. Do not halt until the n^^ 
time this breakpoint is encountered . 



Remove breakpoint ^n. It can then be assigned to 
another address, if desired. 

Remove all breakpoints. 
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To Use Symbols (Tags) 



progname$: Before the user can type DDT comnrKJnds which re-- 

ference symbols In his program Symbol Table, he 
must type this entry to select the appropriate Symbol 
Table. 



To Assign a Symbol (Tag) to an Address 
adr/ contents symbol: 



Assigns the name "symbol" to adr (the last location 
opened by DDT) and places the appropriate entry in 
the Symbol Table. 



To Assig n a Value to a Symbol 
value<symbol : 



Assigns "value" to the name "symbol" and places 
the appropriate entry In the Symbol Table. This 
function is similar to that of the Direct Assignment 
state ment in Macro-IO. 
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To Examme and Modify the Contents of a Program Storage Location 



adr/ contents 



( LINE FEED) 



Type out the contents of adr (symbol ic or absolute) 
ond open the location. If adr is a point (./), the 
contents of the currently open location are typed . 

Following the typeout, the contents can be changed 
by typing the new contents: 

adr/ contents new-contents 

Several returns can be made following these opera- 
flons. All returns place the new contents (if any 
have been typed) into the currently open word and 
then close the word . 

Executes a carriage return, line feed, and waits for 
the next command . 

Executes a carriage return, line feed; increments 
the pointer by 1 to the next program storage loca- 
tion; types out the address of the new location and 
its contents and opens the location. 

Executes a carriage return, line feed; decrements 
the pointer by 1 to the preceding program storage 
location; types out the address of the new location 
and its contents and opens the location . 

Retype the contents of the location lost typed out, 
this time numerically in the current radix mode 
(normally octal). Used when the symbolic type- 
out is meaningless, as in the case where numeric 
data is stored in the location. 

adr/ contents (symbolic) = contents (in current 
radix) 
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I EXAMPLE 

.DDT^ 

TEST2$: ti 
LOOPS IBj^ 

START$G^ 

$lB»LOOP-i>l COUNT/-0I MOVE 1 
$P^ 



,ctrJ 



$1 B» LOOP-i>| CTR/h^ (garbage)-c>i = 173456321 0 ji 



Select the Symbol Table of the 

program namea TEST2J 

Set breakpoint- ^1 at the location 

LOOP- 

Start the program execution at sym- 
bolic location START. 

Breakpoint ^1 has been encountered. 
User requests typeout of contents of 
location COUNT. User decides to 
proceed until breakpoint is reached 
again . 

Breakpoint ^1 has again been encount- 
ered . User requests typeout of con- 
tents of location CTR. Since the 
contents of CTR as a symbolic instruct- 
ion are meaningless, the user types = to 
request retyping of contents in the cur- 
rent radix (octal). 



TST/-0I ADD 4,@NUM(17)-o| ADD 4,@NUM(16) (LlNE FEED )) User requests typeout of location TST 

^ and changes its contents. LINE-FEEt 



TST+l/-olJRST4,TEMP-t>| ^ 
0$1Bh>| SUBRTE$G^ 

EXIT^ 



FEED 

typein causes typeout of address and 
contents of next sequential location. 

Remove breakpoint ^1; resume ex- 
ecution at location SUBRTE. 

Program execution is finished; auto- 
matic return to the Monitor. 



The Teletype keys ALTMODE (ALT)/ PREFIX, or ESCAPE (ESC) are all equivalent to the $ in DDT 
commands (except when typing in text strings). 
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SUMMARY OF DDT COMMANDS 



Type-Out Modes 






To set the type-out mode to: 


Type this 


Sample Output(s) 


Symbolic Instructions 


$s 


ADD 4, TAG+1 
ADD 4, 4002 


Numeric, in current radix 


$c 


69. 

105 


Floating point 


$F 


0.125E-3 


7-bit ASCII text 


$T 


PQRST 


SIXBIT text 


$6T 


TSRQPO 


RADIX50 


$5T 


4 DDTEND 


Halfwords, two addresses 


$H 


(4002) 4005 
(X+1) X+4 


Bytes (of n bits each) 


$nO 


$80 could yield 
0,14,237,123,0 


Address Modes 






To set the address mode for typeout of symbolic 


insfructions and halfwords (see examples 


above) to 






Relative to symbolic address 


$R 


TAG+1 


Absolute numeric address 


$A 


4005 


Radix Change 






To change the radix of numeric typeouts to n (for n >2), type 






$nR 


$2R could yield 




1 1 01 01 1 0000001 000000000001 1 1 001 01 1 00 


Permanent vs Temporary Modes 






To set a temporary type-out or address mode 
or a temporary radix as shown in the com- 
mands above, type 


$ 


$c 

$10R 


To instead set a permanent type-out or address 
mode or a permanent radix. In the commands 






above, substitute 


$$ 


$$C 
$$10R 
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Permanent vs Temporary Modes (cont) 


Type this 




Sample 


Outputs) 


To terminate temporary modes and revert to 
permanent modes, or re-enter DDT, type a 
carriage return. 










Initial permanent (and temporary) modes are 


$$s 

$$R 
















Examining Storage Words 










To open and examine the contents of any 
address in current type-out mode 


adr/ 




LOC/ 


(254020)DDTEND 


To open a word, but inhibit the type out 
of contents 


adr! 




LOG! 




To open and examine a word as a number 
in the current radix 


adr[ 




LOC[ 


254020003454 


To open and examine a word as a symbolic 
instruction 


adr] 




LUv-J 




To retype the last quantity typed (particu- 
larly used after changing the current 
type-out mode) 






$F; 
$6T; 


#5.4999646E+11 
5%0 <L 


Examining A Related Storage Word 










To close the current open word (making any 
modification typed in) and to open the 
following related words, examining them 
in the current type-out mode: 










To examine adr +1 


^ (line feed) 






To examine adr -1 


^ (or backspace, 
on the Teletype 
Model 37) 




To examine the contents of the location 
specified by the address of the last 

1 It 111 1 1-* 

quantity typed, and to set the location 
pointer to this address 


-rt(TAB) 






To examine the contents of address of last 
quantity typed, but not change the loca- 
tion pointer 


\ (backslash) 






To close the currently open word, without 
opening a new word, and revert to per- 
manent type-out modes. 


(carriage return) 




One-Time Only Typeouts 










To repeat the last typeout as a number in 
the current radix 
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One-Time Only Typeouts (conf) 


Type this 






To repeat the last typeout as a symbolic 






instruction (the address part is determined 


<— 






by >A or 








To type out. In the current type-out mode. 


/ 






the contents of the location specified by 








the address in the open instruction word, 








and to open that location, but not move 








the location pointer. 








To type out, as a number, the contents of the 








location specified by the open instruction 








word and to open that location, but not move 








the location pointer. 


[ 






To type out, as a symbolic instruction, the 








contents of the location specified by the 








open Instruction word, and to open that 








word, but not move the location pointer. 


] 




Typing In 










Current type-out modes do not affect typing 








in, instead 








To type in a symbolic instruction 


ADD AC1,@DATE(17) 




To type in half words, enclose the left 








null in parenrneses. 


(402)403 






To type In octal values 


1234 






To type In a fixed-point decimal integer 


99. 






To type in a floatlna-DoInt number 


101 .11 
77. OE+2 






To type in up to five 7-bit PDP-10 ASCI T 








characters, left justified, delimited by any 








printing character 


"/ABCDE/ 


(/is delimiter) 




To type in one PDP-1 0 ASCI I character, 








right justified 


"A$ 


($ must be ALTMODE) 




To type in up to six SIXBIT characters. 








left justified, delimited by any printing 








character 


$"ABCDEFGA 


(A is delimiter) 




lu iype in one jiADii cnaracTer, right 








justified 


$"Q$ 


($ must be ALTMODE) 


Symbols 


To permit reference to local symbols within 




Example 




a program titled "name" 


name$ : 


MAIN.$: 




To insert or redefine a symbol in the symbol 








table and give it the value n 


n<symbol: 


14<TABL3: 
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Symbols (cont) 


Type This 


Example 


To insert or redefine a symbol in the symbol 
table, and give it a value ecjual to the 
location pointer (.) 


symbol: 


SYM: 


To delete a symbol from the symbol table 


symbol $$K 


LPCT$$K 


To kill a symbol for typeouts (but still permit 
it fn hp used for tvoina in) 


symbol $K 


TBIT$$K 


To perform $K on the lost symbol typed out 
and then to retype the lost quantity 


$D 




To declare a symbol whose value is to be 
defined later 


symbor 


JRST AJAX^ 


To type out a list of all undefined symbols 
(which were created by ^) 


? 




Special DDT Symbols 






To represent the address of the location 
pointer 


. (point) 




To represent the last quantity typed 


$Q 




To represent the indirect address bit 


@ 




To represent the address of the search mask 


$M 




To represent the address of the saved flags, 
etc. 


$1 




<v *■ *J.ll.i 

To represent the pointers associated with the 
nth breakpoint 


$nB 




Arithmetic Operators Permitted in Forming Expressions 






Two's complement addition 


+ 




Two's complement subtraction 






inTeger muir ipi icarion 






inreger aivision ^remuintier uiavi>uiucuy 


' (apostrophe) 




Hierarchical parentheses 


(( )) 




Field Delimiters in Symbolic Typeins 






To delimit op-code name, type one or 






more spaces 






To delimit accumulator field 






To delimit index register 


( ) 




To indicate indirect addressing 


@ 
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Breakpoints (cont) 


Type this 


Example 


To set a specific breakpoint n (Kn<8) 


adr $nB 


CAR$8B 


To set the next unused breakpoint 


adr$B 


303$B 


To set 0 breakpoint with automatic proceed 


adr$$nB 
adr$$B 


CAR$$8B 
303$$B 


lo set a breakpoint which will automatically 
open and examine a specified address ,x 


adr(x)$nB 
adr(x)$B 
adr(x)$$nB 
adr(x)$$B 


Z+6(AC3)$5B 
ABLE(AC4)$B 
Z4^(AC3)$$5B 
ABLE(AC4)$$B 


To remove a specific breakpoint 


0$nB 


0$8B 


To remove all breakpoints 


$B 


$B 


To check the status of breakpoint n 


$nB/ 




* yj yjiKjy^^sssj II will u Ui CvlKIJvJI iii 




io 

■>r 


To set the proceed count and proceed 


n$P 


25$P 


To proceed from a breakpoint and there- 
after proceed automatically 


$$P 
n$$P 


$$P 
25$$P 


Conditional Breakpoints 






To insert a conditional instruction (inst), or 
call a conditional routine, when breakpoint 
n is reached 

If the conditional instruction does not cause 
a skip, the proceed counter is decremented 
and checked. If the proceed count <0, a 
break occurs. "" 


$nB+l/ 0 
For example 

$26+1/ 0 


inst 

CAIE 3,100 


11 iiic (i^uiiui r 1 Qna 1 indTruciion or suDrouTine 
causes one skip, a break occurs . 






If the conditional instruction or subroutine 
causes two skips, execution of the program 
proceeds . 






Starting the Program 






To start at the starting address in JOBSA 


$G 


$G 


I \j diui 1 , \jt cw/riTinue, ui a spec i ilea oaoress 


aar ^\jf 




To execute an instruction 


inst $X 


JRST 2,@JOBOPC$X 
returns to program 
after ^ C and . DDT 
command sequence 
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Searching 


Type this 


Example 


To set a lower limit (a) , an upper limit 


a<b>$W 


200<250>0$W 


(b) , a word to be searched for 






(c) , and search for that word 






To set limits and search for a not-word 


a<b>c$N 


351<721>0$N 


To set limits and search for an effective 






address 


as D->ci>t 




To examine the mask used in searches 






(initially contains all ones) 


$M/ 


$M/ -1 


Trk I ncorf nnn^Vi^r ni inntitv n In the mask 

1 U 1 1 idC^I 1 U 1 lUI lid UUUI illlV II III iil^ iiiu^rv 


n$M 


777000777777$M 


Zeroing Memory 






To zero memory, except DDT, locations 


$$z 




9n_1 nrtrl fko c\/mkril fohlp 

1 o/ , una rne ayiriuui luuic 




To zero memory locations rlKST through 






LAST inclusive 


CTD CT>^I ACT itCT 




Special Characters Used in DDT Typeouts 


Typeout 




Breakpoint stops 






Break caused by conditional break 


> 




instruction 






Break because proceed counter<0 


» 




Undefined symbol cannot be assembled 


U 




Half-word type-outs 


(401)402 




Left hand is enclosed in parentheses 






Unnormalized floating-point number 


#1.234E+27 




To indicate an integer is decimal, the 


$10R 77= 


63. 


Hprlmnl Doint is orinted 






Illegal command 


? 




If all eight breakpoints have been assigned 


? 




RUBOUT echo 


XXX 




Paper Tope Commands (Available only in EDDT 


Type this 




To punch a RIM10B loader 


$L 




To minr^U r>hpr>KCi immPfl flatn blocks where 






ADR1 is the first, and ADR2 is the last 






location of the data (("TAPE) is^R) 


ADRKADR2 CTAPE; 
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Paper Tape Commands (conf) 




1 o min^h n r^n^— \A//*\if*^ nl^^L' f*/^ <^mieA 
I Kj i^uiiv^ii u W/ilc; WQJiU QIOCK TO CuUSe Q 

transfer to adr after the preceding pro- 
gram has been loaded from paper tape 


adr$J 


To read (Yank) a tape into core starting at 
ADR1, up to ADR2 


adr1<adr2$Y 


To verify a tape with core, starting at 
ADRl , up to ADR2 


adrl<adr2$V 
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EXAMPLES 



.DDT^ 

PROGl$:^ 
4505$3B ^ 

$3B+l/-i>|0-o|CAIE AC1,100^ 



$3B+2/-p|0hH200^ or 200$P^ 



$3B»4505^ 
CTR$E^ 



4517/h>|SETZM 
4721/-i>|MOVEM2,CTR^ 
5000/ -ol MOVE 3/5)4721^ 



Select f-he appropriate Symbol Table. 

Set 0 conditional breakpoint (break- 
point ^3 at location 4505). 

1 . Insert a conditional instruction 
at $3B+1 ; if the execution of 
this instruction does not cause a 
program counter skip, decrement 
- and test the proceed counter 
($38+2); if a skip occurs, halt 
at breakpoint. 

2. Set the proceed counter at 200. 
If execution of instruction at 
$3B+1 does not cause a program 
skip, decrement the proceed 
counter and test for less than or 
equal to 0; if test succeeds, halt 
at breakpoint; if test foils, con- 
tinue execution . 

Begin execution of program under 
DDT control , 

Breakpoint ^3 occurs; the » indicates 
that the instruction at $3B+1 did not 
cause a skip, but that the proceed 
counter did reach 0. 

Search for and type out all instruction 
words which reference the location 

CTR. 



(indirectly addresses CTR through ad- 
dress 4721) 
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$A$HBUFFl/_t^ (4003) 4502[ ^ (0000) 0000^ 



4003<4502>$$Zf; 



4003/ -t>| O-0{ 000067777777 iINE-FEED) j 



4004/ -H 0-Pt -9980 . One-feed) 



4005/-H 0 -on2.34E5 ClINE-FEED) ^ 

4006/-H 0 -pf"%TEXT%^ 

0$3B$P(^ 

EXIT^^ 



Type out the contents of location 
BUFFI in half-word, current radix 
mode; type out the contents of the 

last address typed (4502) « 

Zero out core from location 4003 
through 4502^ inclusive. 

Enter the octal value 000067777777 
into location 4003: open next loca- 
tion , 

Enter the fixed decimal value -9980 
into location 4004; open the next 
location . 

Enter the floating point value 12.34 
with an exponent of 5 into location 
4005; open the next location . 

Place the ASCII characters "TEXT" 
into location 4006, left justified , 

Remove breakpoint ^3 and resume ex- 
ecution . 

Program execution is finished; auto- 
matic return to the Monitor. 
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I DIAGNOSTIC MESSAGES 



Table DDT-2 DDT Diagnostic Messages 



Message 


Meaning 


? 


An illegal command has been entered or an attempt has been made 
to select more than eight breakpoints. 


U 


An undefined symbol which cannot be assembled has been 
entered . 
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CROSS-REFERENCE LISTING (CREF) 



FUNCTION To produce a sequence-numbered assembly listing 

followed by one to three tables, one showing cross 
references for all operand-type symbols (labels, 
assignments, etc.) / another showing cross references 
for all user -defined operators (macro calls, OPDEF's 
etc.)/ and another (if the proper switch is specified) 
showing the cross references for all op codes and 
pseudo-op codes (MOVE,XALL, etc.). 

The input to CREF is a modified assembly listing file 
created during a Macro-10 assembly when the /C 
switch is specified in the command string. 

• Provides an invaluable aid for program debug- 
ging and modification 



ENVIRONMENT 



Monitor 


All 


Minimum Core 


2K 


Additional Core 


Takes advantage of any additional core available, 
as necessary. 


Equipment Required 


One input device (normally disk) which contains 
the modified assembly listing file; one output device 
(normally the line printer) for the listing. 
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I INITIALIZATION 



.R CREFj^ Loads the Cross-Reference Listing pro- 

gram into core, 

^ The program is ready to receive a 

command. 



COMMANDS 



General Command Format 



ou tpu t-dev : <— i npu t-dev :f 1 1 ena me . ext 

output-dev: The device on which the assembly listing and cross- 

reference tables are to be printed (LPT: is assumed 
if device is not specified) . 

input-dev: The device on which the modified assembly listing 

was written during Macro- 10 assembly (DSK: is 
assumed if device is not specified) . 



filename. ext (DSK: or DTAn: only) 



The filename and filename extension of the modi- 
fied assembly listing file (CREF.TMP is assumed if 

filename ,ext is not specified) . 

The output device and the input device ore sepora-* 
ted by the left arrow symbol » 



Disk File Command Format 



D S K : f i I ena me • ex t [pro j , progj 
[ pro i, prog] 



Project-programmer number assigned to the disk area 
to be searched for the source file if other than the 

user^s project-programmer number « 
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EXAMPLES 



.R MACRO^ 

* PTP: ,/C < DTA1 :TXCALCjJ 

THERE ARE NO ERRORSj^ 
PROGRAM BREAK IS 003771(} 
6K CORE USED^ 

.RCREF^ 



.KJOB^ 



Loads the Macro- 10 Assembler into 
core . 

Assembles the program TAXCALC from 
DTA1; writes the object program cod- 
ing on the paper tape punch; writes a 
modified assembly listing on DSK: 
(assumed) and assigns It the filename 
CREF.TMP, 

Return to the Monitor. 

Loads CREF into core. 

Selects the default assumptions of: 
output-dev: LPT: 
input-dev: DSK: 
filename. ext CREF.TMP 

Return to the Monitor . 

Kill the job, deassign all devices, re- 
lease core. 
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SWITCHES 



Switches are used to specify such options as: 

1 . Magnetic tape control, and 

2. List selection. 

All switches ore preceded by a slash (/) . 



Table CREF-1 CREF Switch Options 



Switch 


Meaning 


A 


■■■'mce magnetic -tape reel by one file; 


B 


magnetic tape reel by one file. 


K 


: listing of references to basic symbo; ■ Is, assignments, etc.). 


M 


listing of references to user-defined operators (macro colls, OPDEF's, etc.). 


O 


Allow listing of references to machine and pseudo-operation codes (MOVE, XALL, 


S 


• Ci. program iisTing (list only the selected tables). 


T 


<.p to logica! end of magnetic tape. 


W 


• ewind magnetic tape. 


z 


„ero the DECtope directory (DECtape must be output only) . 
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EXAMPLES 



.R CREFjJ 

VM<3 MTA1:AV,J 



*DTA5:SAVEl/Z<-,i 



• KJOBjJ 



Loads CREF into core. 

Rewind MTAl and process the first file, 
listing only the cross references for 
operand-type symbols (labels, assign- 
ments, etc .) ♦ 

Process the file named CREF.TMP in 
the user's area of disk; write the pro- 
gram listing and operand-type cross 
references on DTA5 and call the file 
SAVEl . 

Return to Monitor. 

Kill the job, deassign all devices, and 
release core . 
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DIAGNOSTIC MESSAGES 



Table CREF-2 CREF Diagnostic Messages 



Message 


Meaning 


?clev NOT AVAILABLE 


Device is assigned to another job. 


7CANNOT ENTER FILE fnme.ext 


DTA or DSK directory is full; file cannot be entered. 


7CANNOT FIND FILE fnme.ext 


The file cannot be found on the device specified. 


7COMMAND ERROR 


Error in last command string entered. 


7DATA ERROR DEVICE dev: 


Read or write error. 


7IMPROPER INPUT DATA@ 


Input data not in CREF format. 


7 INPUT ERROR ON DEVICE dev: 


Read error has occurred on the device. 


7INSUFFICIENT CORE 


Additional core is required for execution but none 
is available from Monitor. 
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GLOBAL SYMBOL CROSS REFERENCE LIST (GLOB) 



FUNCTION To read mulHple binary program files produced by 

Macro and F40 and generate an alphabetic cross- 
referenced list of all global symbols encountered. 



I ENVIRONMENT 



Monitor 


Afl 


Minimum Core 


2K 


Additional Core 


Requests additional core from the monitor as required. 


Equipment 
Required 


An input device for each binary file to be scanned for 
global symbols and one or more listing devices for 
output. 
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I INITIALIZATION 



.R GLOBj^ 



COMMANDS 



Loads f-he Global Symbol Cross-- 
Reference Listing program , 

The prograrn is reody to receive 
a command. 



Input Command 

devifilenome.ext, . . . . filename. ext,dev:fllename.ext, . . . .filename.ext, . 

The dev!ce(s) containing the binary program flies 
to be scanned. 

MTAn: (magnetic tape) 

DTAn: (DECtape) 

DSK: (disk) 

PTR: (paper tape reader) 



filename. ext (DSK: and DTAn: only) 



The filename and fifename extension of each binary 
progrom which resides on either disk or DECtape* 



Output Command 



dev:< — (ALTMODE) 



dev: 



The device on which the global symbol listing is to 
be printed « 

LPT: (line printer) 
TTY: (Teletype) 

Other outpyr devices can be specified if desired. 

More than one output command can be given if it 
is desired to produce several types of listings on 
several different devices. Each new output com- 
mand is typed after the previous request has been 
completed * 
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EXAMPLES 



.R GLOB^ 

*DSK:F1 ,F2,DTA3:CALC1 ,CALC5(i 
*IPJ:< (ALTMODE) j 



.KJOB^ 



The binary program files fo be scanned ore Fl and 
F2 on DSK, and CALC1 and CALC5 on DTA3. 

All global symbols In these programs are to be 
listed on the printer. Printed with each symbol are 
its value, the name of the program in which it was 
defined, and the names of all the programs in which 
it was referenced (i.e., declared external). 

Return to the Monitor. 

Kill the job, deassign all devices, and release core. 
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I SWITCHES 



The switches available In Glob are used to determine the types of global symbols to be listed 
on each of the specified output devices. If no switches are typed, all global symbols are 
listed. 

All switches are either preceded by a slash or enclosed in parentheses and can appear anywhere in the 
output command string. However, only the most recently specified switch is in effect at any given 
time . 



Table GLOB-1 GLOB Switch Options 



Switch 


Meaning 


A 


A!! global symbols are to be llsl"ed (assumed if no switch Is Qivsn), 


E 


list erroneous (multiply defined or undefined) symbols . 


F 


List fixed (nonrelocotable) symbols only. 


N 


List only those symbols v/hich are never referred to. 


R 


-..ist reiocatable symbols only. 


S 


List r?iultiply specified (I.e., symbols defined in more than one program, but with non- 
confiicting values) only. 


X 


Omit printing of listing title when oufpuf h other than TTY„ Include printing of listing 
title when output is TTY. 

NOTE: Normally^, the title is printed on all devices except the Teletype. 
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EXAMPLES 



.R GLOB^ 

*DTA1:TEST1 .REL,SUBRTE,DSK:ARITH1 ,^ 
*SCIENC,RETEST^ 

* LPT:< /R (ALTMODE) ^^ 

*TTY:«J /E (ALTMODE) j 

U EXTSYM SUBRTE 
.KJOB,^ 



The binary programs to be scanned are 
files TESTl .REL and SUBRTE on DTAl , 
and ARITH1 , SCIENC, and RETEST on 
disk . 

List" only relocatable symbols on the 
printer. 

Printer listing is completed. Enter 
command to print all erroneous sym- 
bols on the Teletype. 

("U" = Undefined; "EXTSYM" is the 
undefined symbol; "SUBRTE" is the 
program in which EXTSYM appears.) 

Return to the Monitor . 

Kill the job, deassign all devices, 
and release core . 
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I DIAGNOSTIC MESSAGES 



Table GLOB-2 GLOB Diagnostic Messages 



Message 


Meaning 


?COMMAND SYNTAX ERROR 


An Illegal command string has been entered. 


. Uto 1 IINA 1 IvJIN UtVlCt bKKUR 


An I/O error has occurred on the output device. 


7DIRECTORY FULL 


No more files can be added to the directory of the 
output device . 


?dev NOT AVAILABLE 


The device either does not exist or has been as- 
signed to another job. 


?niename.exi- NOT FOUND 


The filename.ext cannot be found in the directory 
of the device specified. 


?TABLE OVERFLOW - CORE UUO FAILED 
TRYING TO EXPAND TO xxx 


GLOB requested additional core from the Monitor, 
but none v/as available. 



Table GLOB-3 GLOB Error Flags 



Flag 


Meaning 


M 


Multiply defined symbol (all values are shown). 


N 


Never referred to (i.e., was not declared external in any of the binary programs). 


S 


Multiply specified symbol (i.e., defined in more than one progarm, but with non- 
conflicting values). In the listing, the name of the first program in which the symbol 
was found is followed by a plus sign. 


U 


Undefined symbol . 
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PERIPHERAL INTERCHANGE PROGRAM (PIP) 



FUNCTION 



To transfer data files from any standard I/O device 
to any other standard I/O device; additionally, to 
perform simple editing and magnetic tape control 
functions. PIPl , a compact version of PIP, per- 
forms a subset of PIP functions. 

• Handles all data formats 

• Eliminates the need for a satellite computer 
to handle off-line data conversions 



ENVIRONMENT 





PIP 


PIPl 


Monitor 


All 


All 


Minimum Core 


3K 


IK 


Additional Core 


IK if disk is one of the I/O 
devices; any core above that 
required is used for extra I/O 
buffers. 


Any core greater than 1 K is 
used for extra input buffers. 


Equipment 
Handled 


DECtape, disk, magnetic tape, paper tape reader, paper tape 
punch, card reader, line printer, and Teletype. 
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I INITIALIZATION 



RPIP^ -RPIPg Loads PIP (or PIP I) into core, 

. PIP is ready to receive a command; on 

asterisk is typed after each requested 
action has been completed . 



COMMANDS 



General Command Format 



destInation-dev:filename.ext<j source-dev:f!lename .ext, . . . source-n^ 

destmatlon-dev: The destination device, to which the dato is to be 

source-dev: transferred; the source device(s), from which the 

data is to be read 



DTAn: 


(DEC tape) 1 


PTR: 


(paper tape reader) 


PIP: 


(paper tape punch) 


DSK: 


(disk) 


CDR: 


(card reader) 


MTAn: 


(magnetic tape) 


LPT: 


(line printer) 


TTY: or 


(Teletype) 


TTYn: 





if more than one file Is to be transferred from a 
magnetic tape^ card reader. Teletype, or paper 
tape reader, dev: is fo! lowed by a comma for each 
file after the first; these devices con also be fol-" 
lowed by * or * to indicate aU files ore to be 
transferred . 



filename. ext (DSK: and DTAn: only) 



The filename and filename extension to be assigned 
to the file on the destination dev ice; the filename 
and filename extension of the file(s) to be read from 
the source device . 

An asterisk can be used for source files as follows. 

filename.* - Transfer all files having the 

specified filename. 

•^x^" - Transfer ali files having the 

specified extension. 



* 



If logical device SYS (the CUSP device) is a DECtope, If must not be modified using the /R or /D 
switches or any other request requiring it to be initialized for input and output at the same time. 



PIP-2 



- Transfer all files . 

- Transfer oil files with 
null extensions. 

The destination descriptors and the source descriptors 
ore separated by the left arrow symbol {< ). 



Disk File Command Format 
DSK:filename.ext[proj,prog] <protectlon> 
[ pro j, prog] 

< protection > 



Project-programmer number assigned to the disk 
area to be used, if other than the user's project- 
programmer number. 

Protection value to be assigned to the destination 
file. If omitted^ the standard protection is assigned. 



Standard Assumptions 

Unless otherwise changed by switches, all files which are on directory devices and which 
have a filename extension of .REL, .SAV, .DMP, or .CHN are copied in binary; all other 
files are assumed to be in ASCII line mode. Magnetic tape files, unless otherwise changed 
by switches, are read in odd parity and written in odd parity at 556 bpi . 



Standard protection (055) designates that the owner is permitted to read or write, or change the protec 
tlon of, the file while others are permitted only to read the file. 
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EXAMPLES 



.R PIP^ 

*LPT:< DTAhFILEl^ 

*LPT:< DTAl:*^ 

* DTA2:FILE2 < — DTAl :FILE1 .TMP^ 
*DTA2:FILE3 <— DTA1:FILE1,FILE2^ 

* DTA2:FILE3 < DTAl :FILE1 ,DTA3:FILE2 ^ 

*DSK:FILE1<»— MTAI:^ 

* DSK : FI LE 1< 1 77> <l — MT A 1 *^ 

*DSK:FILEl[l,3]<»— MTAl:,^ 

*PTP:<J— PTR:,,,,^ 
.KJOB^ 



Transfer the file named FILEl from 
DTAl to the line printer. 

Transfer all files with null extensions 
from DTAl to the line printer. 

Transfer the file named FILEl .TMP 
to DTA2 and give it the name FILE2. 

Transfer the files named FILEl and 
FILE2 from DTAl to DTA2, combinlna 
them as one file under the name FILES. 

Transfer the file named FILEl from 
DTAl and the file named FILE2 from 
DTA3 to DTA2, combining them as 
one file under the name FILE3. 

Transfer the next file from the present 
position of MTA1 to the user's area on 
the disk, call it FILEl, and assign the 
standard protection of 055. 

Transfer all files from MTA1 (starting 
at the current position of the read 
head) to the user's area on the disk, 
combining them into one file called 
FILEl, and assign protection 177. 

Transfer the next two files from the 
present position of MTAl to area 1 ,3 
on the disk, combining them into one 
file called FILEl , and assign the 
standard protection (055). 

Transfer five files from the paper tape 
reader to one file on the paper tape 
punch . 

Return to Monitor, 

Kill the job, deassign all devices, 
and release core . 
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SWITCHES 



Nonmagnetic-tape switches, when used, are preceded by a slash (if more than one Is 
specified, they may be enclosed by parentheses instead) and may appear anywhere in the 
command string; however, if the command string contains commas, the switches must be 
specified prior to the first comma. 

Magnetic tape switches are enclosed by parentheses and must appear immediately following 
the device or file to which they refer. 

Switches ore used to specify 

1 . Particular files for transferral or deletion; 

2. Editing; 

3. Mode of transfer; 

4. Directory manipulation (DECtape and DSK); and 

5. Magnetic tape control. 

A listing of PIP switches can be obtained by typing 

* output-dev:/ Q < — ^ 
where output-dev: may be either LPT: or TTY: 

Table PIP-1 PIP Switch Options 



Switch 


Meaning 








Process file in binary mode. 


C 


■ "<ng spof - ■ : ■ " multiple 


D 




E 


I'card't columns 73 through 80 as spaces. 


F 




G 


e I/O errors . 


H 




I 




L 


List the directory (DSK: or DTAn: only) 


NOTE: i . Available l^, :- 
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Switch 



Table PIP-1 PIP Switch Options (Cont) 
Meaning 



Magnetic tope switches » A string of one or more magnetic tape switches begins with an M 
and is enclosed in parentheses. 



*nA 


Advance f-he tape n files. 


E 


Even parity . 


#nB 


Backspace the tape n Files. 


F 


Mark EOF. 


2 


200 bpi density. 


T 


Skip to logical end of tape 


5 


556 bpi density. 






8 


800 bpi density. 


U 


Rewind t. unload. 


A 


Advance tape one file. 




Rewind f 


B 


Backspace tape one file. 







NOTE: MTA switches always opp!y to the device or file immediately preceding the switches. 



IN 


.^eiete the sequence numbers from a file. 


o 


ame as /S switch except sequence numbers are incremented by 1 , 


p 


FORTRAN output file format assumed as Inpuf . Convert format control characters for lir 
printer Us tine 


Q 


""int this list of i>. 


R 


■ Renome the file . 


si 


Add sequence numbers to the file or resequence a file already containing sequence numbers; 
sequence numbers are incremented by 10. 


T 


Suppress trailing spaces , 


U 


Copy blocks 0, 1 and 2 u ,iu. . wi^rnhioa^y usea ro rransrer itNu 


V 


C ount un-^ 


X 


Copy spec. 


Y 


Perform a RIM i .• lO r , r convt-rsron , 

Source extension: Destination format: 

•RTB RIM Loader, RIMIOB File, 

XFERWD 

'■>'^V RIMIOB File only. 

RIMIO 




Zero out the directory (DTAn: or DSK : only). 


NOTE: 1 . Available for use in PiPl . 
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EXAMPLES 



.R PIP^ 

*DSK:/X<3 — DTAl:*.*j 
*DSK:(DX) < — DTA1:FILE1 / .REL^ 

*MTA2:/S< — CDR:^ 
*LPT:/P < DTA1:FILE1 ^ 

*DTA2:FILE1/I<1 — PTR:^ 



*TTY:/L< DTAl:^ 

nnnn FREE BLOCKS LEFT^ 
filename .ext creation date^ 



Transfer all fUes from DTAl to DSK, 
keeping them separate and retaining 
their filenames. 

Transfer all files, except FILEl and 
any files with the extension. .REL, 
from DTAl to DSK, keeping them 
separate and retaining their filenames. 

Transfer a file from the card reader to 
MTA2 and add sequence numbers. 

Take FILEl (a FORTRAN output print 
file), interpret the carriage control 
characters, and print it. 

Initialize both DTA2 and the paper 
tape reader in image mode and trans- 
fer one file from the paper tape reader 
to DTA2, calling it FILEl . 



List the directory of DTAl on the 
Teletype . 



*DTA1:/Z<J-^ 

*MTA2:(M8E) < MTAl :(ME8) J 

*MTA2:(MW)<3— ^ 

*LPT:< — MTA1:(M2W),(MA),,^ 



*MTA1:(M#4A)<— CDR:^ 
.KJOB^ 



Zero the directory of DTAl • 

Transfer a file from MTAl to MTA2 in 
800 bpi, even parity mode . 

Rewind MTA2. 

Set MTAl to 200 bpi, odd parity, 
rewind the tape, and transfer the first, 
third, fourth, and fifth files to the 
printer. 

Advance MTAl four files before trans- 
ferring a file from the card reader. 

Return to the Monitor. 

Kill the job. 
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DIAGNOSTIC MESSAGES 



Table PIP-2 PIP Diagnostic Messages 



Message' 


Type^ 


Meaning 


?4K NEEDED 


S 


4K is not currently available but is needed 
when a disk is present in the system. 


?DECTAPE I/O ONLY 


S 


I/O device for copy block 0 (/U) must be 
a DECtape. 


?DEVICE dev:DOES NOT EXIST 


I/O 


Either device name has been misspelled 
or there is no such device. 


? DEVICE dev:NOT AVAILABLE 


I/O 


The device has been assigned to another 
job. 


? DIRECTORY FULL 


FR 


There is no room for an entry in a DEC- 
tape directory. 


DISK DIRECTORY READ^ 


I/O 


Followed by a second message (see 
Table PIP-3). 


?DISK OR DECTAPE INPUT REQUIRED 


I/O 


This command requires a directory device 
for input. 


?DTA TO PTP ONLY 


RIM 


DTA input and PTP output must be speci- 
fied for /Y. 


?FILE filename. ext ILLEGAL EXTENSION 


RIM 


Extension for /Y request must be .RMT, 
.RTB, or .SAV. 


FILE filf»nnmo t^vtlllFf^AI FOPKAAT 


RIM 


1 . z_ero lengrn nie; or 

2. Requisite job data info not available; or 

3. Block overlaps previous block (RIM 10) or 

4. EOF found when data was expected, or 

5. A pointer word was expected but not 
found in the source file. 


FILE PROTECTION FAILURE DURING 
(/X, /Z, /D) REQUEST 


S 


Each file requested does exist, but one or 
more was unavailable for processing. 
This message is never fatal . 


NOTES: 1 . All fatal diagnostic messages are preceded by a question mark (?). 

2. Type of message: 

C Command string error 
PR File reference error 
I/O I/O error 

RIM Read-In-Mode specification error. 
S Other types of errors 

3. These messages are nonfatal if the /G switch is used; otherwise, they are fatal and are 
preceded by a ? . 
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Table PIP-2 (Cont) PIP Diagnostic Messages 



Message^ 


Type^ 


Meaning 


?filename.ext FILE WAS BEING MODIFIED 


FR 


Disk file named is currently being pro- 
cessed by another job. 


?filename.ext FILE WAS NOT FOUND 


FR 


Filename. ext not found during LOOKUP. 


?filename.ext ILLEGAL FILE NAME 


FR 


Indicates that 

1 . No filename was specified for DTA 
outout file: or 

1 V 1 III W f x^l 

2. A reject occurred on a /R request 
for disk file; or 

3. Illegal filename was specified for a 
/R request on DTA. 


?filename.ext INCORRECT PROJECT- 
PROGRAMMER NUMBER 


FR 


The project-programmer number specified 
for a DSK file is incorrect. 


INPUT DEVICE dev: FILE filename. ext^ 


I/O 


Followed by a second message (see 
Table PIP-3). 


?LINE TOO LONG 


s 


A line >140 characters was detected in the 
source file 


?LOAD POINT BEFORE END OF (MB) 
REQUEST 


s 


Load point on a magnetic tape file has 
been reached before the tape has been 
backspaced the number ot tiles specitied 
in (M#nB). 


?NO BLOCK 0 COPY 


c 


/U given but PIP assembled without 
provision for this. 


?NO FILE NAMED filename. ext 


FR 


No such file found during PIP directory 
search. 


?NO FILE NAMED QPIP 


s 


The data file for the /Q switch is not 
available. 


OUTPUT DEVICE dev: FILE filename. ext 


I/O 


Followed by a second message (see 
Table PIP-3. 


NOTES: 1 . All fatal diagnostic messages are preceded by a question mark (?). 

2. Type of message: 

C Command string error 
FR File reference error 
I/O I/O error 

RIM Read-In-/v»o_e specification error. 
S Other types of errors 

3. These messages are nonfatal if the /G switch is used; otherwise, they are fatal and are 
preceded by a ?. 
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Table PIP-2 (Cont) PIP Diagnostic Messages 



Message ' 


Type^ 


Meaning 


?PIP COMMAND ERROR 


C 


1 . Illegal format for command string; or 

2. Nonexistent switch requested; or 

3. Filename. ext other than 
* (or *.*) requested for 

0 nondirectory device; or 

4. The illegal switch combination RX. 


?filename.ext PROTECTION FAILURE 


FR 


Same as "FILE PROTECTION FAILURE 

DURING ..." message except that the 

* 111. 
processing halts. 


7TERMINATE /X MAX OF 999 FILES 
PROCESSED 


S 


The /X switch specified for nondirectory 
device source files has processed the 
maximum number of files (999). 


?TOO MANY REQUESTS FOR dev: 


C 


Conflicting parity and/or density requests 
have been given for a magnetic tape. 


?TRY PIP 


C 


During a PIPl run, a switch or function 
which is not present in PIPl has been 
requested. 


NOTES: 1. All fatal diagnostic messages are preceded by a question mark (?). 

2. Type of message: 

C Command string error 
FR File reference error 
I/O I/O error 

RIM Read-In-Mode specification error. 
S Other types of errors 

3. These messages are nonfatal if the /G switch is used; otherwise, they are fatal and are 
preceded by a ? . 



Table PIP-3 Secondary PIP I/O Diagnostic Messages 



Message 


Device 


Meaning 


BINARY DATA INCOMPLETE ' 

BLOCK TOO LARGE 
CHECKSUM OR PARITY ERROr' 
INPUT BUFFER OVERFLOW^ 
DEVICE ERROR^ 


PTR 

DTA 
All 

All except DTA 
All 


Length of block disagrees with word 
count. 

DTA link numberM IOIq . 

o 

Read or write error. 

Block too large for buffer. 

The data control unit has detected the 
loss of data. 


NOTE: 1 . These error conditions are nonfatal if the /G switch has been specified. 
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Table PIP-3 (Cont) Secondary PIP I/O Diagnostic Messages 



Message 


Device 


Meaning 


PHYSICAL EOT^ 
WRITE (LOCK) ERROR 

7-9 PUNCH missing' 


MTA 

DTA, DSK, MTA, 
CDR 


The end of tape has been reached. 

Attempt has been made to write on a 
write-locked file. 

Binary card lacks 7-9 punch. 


NOTE: 1 These error conditions are nonfatal if the /G switch has been specified. 



IK Version of PIP (PIP1) 

Limitations 

1 . Z and MW requests ignore all source devices. 

2. B switch included since REL, SAV, DMP, and CHN files are not automatically copied i 
bytes . 

3. Error messages assume all I/O devices are DECtape. 

4. Neither project-programmer numbers nor protection can be specified for disk files. 

5. The * cannot be used for filenames or extensions. 

6. SAV files cannot be successfully copied with PIPl . 
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DECTAPE FORMAT CONVERTER (CONVRT) 



FUNCTION convert- DECtapes from the old format to the 

new format (or vice versa).! 

The new format 

• Increases DECtape processing speed by allo- 
cating blocks in a nonconsecutive manner so 
that a continuous read is possible 

• Allows for file deletion to free assigned 
blocks for use by subsequently written files 



I ENVIRONMENT 



Monitor 


All 


Minimum Core 


3K 


Additional Core 


Not used. 


Equipment 
Required 


One or more DECtape units for input: one DECtape unit for 
output. 



1 Note- CONVRT runs on the PDP-6 or PDP-10. However, it does not use the LOOKUP or ENTER 
programmed operators or do standard I/O. As a result, the Monitor is not aware of the directory of 
the output tape (or the input tape) and the tape must be assigned appropriately if it is to be used on 
the machine on which it is converted. 
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INITIALIZATION 



.RCONVRT^ 



COMMANDS 



Loads the DEC tape Format Converter 
program Into core. 

The program is ready for the first 
command . 



General Command Format 

DTAn:<l DTAx:,DTAy: 

DTAn: 

DTAx:....DTAz: 



.DTAz: (ALTMODS 



The DEC tope Oi 

be written. Output is 



converted oufpuf h to 
to be in ne 



The input tape(s) containing the files to be con- 
verted; input is assumed to be in old format. 



The ou 

DECtapfevS/ L'/ 



• Is separoted from the mpuf 
left arrov/ symbol , 
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EXAMPLES 



.R CONVRT^ 

*DTA2:<J — DTAl: (ALTMODE) ^ 
DTAl FINISHED . . 

*DTA3:<— DTA4:,DTA5: CALTMODD ^ 
DTA4 FINISHED. . . WAITJ 
DTA5 FINISHED . . 

• KJOB^ 



Convert the files on DTAl (old format) 
to new format and add them to DTA2. 

Convert the files on DTA4 and DTA5 
(both old format) to new format and 
add them to DTA3, 

Return to the Monitor. 

Kill the job, deassign all devices, 
and release core. 
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SWITCHES 



Switches are used to specify such options as: 

1 . The format of a tape, 

2. The specific files to be copied, 

3. Directory handling, and 

4. Processing continuation. 

All switches can either be preceded by a slash or enclosed within parentheses. Switches normally apply 
only to the device with which they appear and must be specified before any filename. ext given for that 
device . 



Table CONVRT-1 . CONVRT Switch Options 



Switch 


Meaning 


c 


Copy the named files only. 


D 


other than the named files. 


G 


Continue processing. Used only after the operator has mounted a new outDut re>^f 
followmg the MOUNT NEW OUTPUT TAPE message. 


L 


List the directory (source tapes oniy). See format of list shown below. 


N 


Tape is in new format (new format is assumed for the output tape unless otherwise 

specified) . 


O 


Tape is in old format (old format Is assumed for gH source rapes uniess otherwise 
specified) . 


Z 


Zero out the tape directory foufput tape onlyr... 



Dump mode files 
1st block command list word 



2 ("n,y in decimal) 

-5060,59 

108 (last block in use) 

207 



Format of DECtape Directory Listing (/L Switch) 
If DECtape is in old format: 

filename ext date 

CONBSV DMP 2-SEP-67 

COMB 2-SEP-67 



CONVRT-4 



If DECtape is In new format: 



filename 

CONBSV 
CONB 



ext 



SAV 



date 

2-SEP-67 
2-SEP-67 



* of blocks in file 

106 
100 



Dump mode files 
# of IK blocks 
used 



NOTE: When requesting a listing of a directory from a new format DECtape, the user must include 
the /N switch on the source side; otherwise, an old format DECtape is assumed. 

LPT:/L< — DTA1:/N (ALTMODE) 
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I EXAMPLES 



•R CONVRT^ 

*DTA5:/Z<i — DTAl:(C)JOBl ,JOB4,JOB6,DTA2:(Dy 

job.rel C^tmodo ^ 



DTA1 FINISHED . . . WAIT^ 

MOUNT NEW OUTPUT TAPE^ 
/Z/G ^LTMODB ^ 

DTA2 FINISHED . . 
• KJOBJ 



Perform the following steps: 

1. Zero out the directory of DTA5. 

2. From DTAl , convert files JOBl, 
JOB4, and JOB6 (all in old for- 
mat) and write them on DTA5 . 

3. From DTA2, convert all files 
except JOB.REL and write them 
on DTA5 . 

The reel on DTA5 is full; mount new 
output reel and type /Z/G to zero 
the directory of the new output tape 
and to continue processing. 

Return to the Monitor. 

Kill the job, deassign all devices, 
release core . 
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DIAGNOSTIC MESSAGES 



Table CONVRT-2 CONVRT Diagnostic Messages 



Message 


Meaning 


? filename. ext DIRECTORY ENTRY 
INCONSISTENT 


1 . An old format file has word four of the 
directory entry greater than zero and the 
extension is neither CHN nor DMP. 

2. An old format file has the extension SAV 
and word four of the directory entry is zero. 


?DTAn DATA ERROR 


An error has occurred while reading or writing a file. 
The file is deleted from the directory; the directory 
is written on the output tape before this message is 
typed . 


?DTAn DEVICE NOT AVAILABLE 


The DTAn specified has been assigned to another 
job. 


?DTAn DIRECTORY WRITE DATA ERROR 


A parity or data error has occurred while writing 
the directory on the output tape. 


DTAn FINISHED . . . (WAIT) 


Conversion has been completed for all files on the 
specified input tape. If the word "WAIT" follows 
the message, more input files are to be processed; 
if it does not follow, the entire conversion process 
is complete and the output reel can be dismounted. 


?DTAn NO DIR 


A directory block is not recognizable. 


?DTAn WRITE (LOCK) ERROR 


A write error has occurred on the output tape; the 
tape is probably write locked. 


? filename. ext FILE NOT FOUND 


A file specified after a /C or /D switch cannot be 
found on the input tape. No conversion has been 
performed for this tape and only those files men- 
tioned prior to this one have been checked. The 
run is terminated. 


7ILLEGAL COMMAND 


An unrecognizable, incomplete, or illegal command 
string has been typed. The run is terminated. 


? ILLEGAL SWITCH 


An unrecognizable or illegal switch has been typed. 


7IMPOSS. SAVED FILE FORMAT 


This message should never occur. However, 
during a new-to-old format conversion, this type- 
out indicates one of the following conditions. 

1 . Overlapping blocks occurred. 

2. There are more words in the file than are indi- 
cated by the number of IK blocks needed to 
load the file. 
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Table CONVRT-2 (Cont) CONVRT Diagnostic Messages 



Message 


Meaning 


?IMPOSSIBLE CONDITION FOUND 


This typeout should never occur. If it does appear, 
it indicates one of the following conditions. 

' • 1 1 1 wui III wwid III ific uiicu \ \jiy \j\ a savea 1 1 1 e 
on an old format DEC tape is not negative. 

z. . 1 iici c ui c iiu uiucKb Udsociaiea wirn a 

filename .ext in a new format tape directory. 

\j • 1 1 ic wv-»i u ^Vi^uiM III u uiuQ^iN \j\ cj new lormar savea 
file is greater than 128. 


?MORE CORE NEEDED 


Insufficient core is available for processing the last 
command string. 


vBELUMQUNT NEW OUTPUT TAPE 


The current output tape if full. Dismount the tape, 
mount a new tape, and type /G to continue. 


(BELL) ? MOUNT NEW OUTPUT TAPE 


An incorrect response to the previous typeout of 
this message was entered. 


?dev: NOT A DECTAPE 


All selected devices must be DECtapes. 
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CODE TRANSLATOR (CODE) 



This section was not available at publication time, but will soon be available as an insert. 
If you do not receive this insert, please write to: 

DEC Program Library 

Digital Equipment Corporation 

146 Main Street 

Maynard, Massachusetts 01754 
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SOURCE COMPARE (SRCCOM) 



FUNCTION 



To compare, line by line, two versions of a source 
file coded as lines of ASCII characters and to output 
any differences. 



ENVIRONMENT 



Monitor 


All 


Minimum Core 


3K 


Additional Core 


The minimum core allows for o look-ahead capability of 44l0 lines 
minimum. Each additional 1 K of core increases this capability by 
32lo lines. 


Equipment 
Required 


Two input devices for the two files to be compared; one output device 
for listing the differences. Both input files can be on disk. 
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INITIALIZATION 



, R SRCCOM^ Loads the Source Compare royHne« 



Source Compare is ready fo receive a 
command , 



COMMANDS 



General Command Format 

list-dev:filename.ext< input! -dev: filename .ext, input2-dev:niename .ext^ 

list-dev: Jhe device on which the differences are to be listed. 

LPT: (line printer) 
TTY: (Teletype) 
MTAn: (magnetic tape) 
DTAn: (DECtope) 
DSK: (disk) 

input! -dev: The devices on v/hich the two source files to be 

input2-dev: compared are located. 

DTAn: (DECtope) 

DSK: (disk) 

PTR: (paper tape reader) 



filename. ext (DSK: and DTAn: only) 



The filename and extension of either of the input 
source files , 

The filename and extension to be assigned to the 
output list file . 

The output device is seporated from the input source 
file devices by the left arrow symbol. 
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EXAMPLES 



. R SRCCOM^ 

* LPT: < DTA2: SOURCE . 001 , DT A3: SOURCE . 002^ 



* LPT: < DSK:TRY1 , DSK:TRY2^ 

. KJOB^ 



Compare the source file SOURCE. 001 
on DTA2 with the source file 
SOURCE. 002 on DTA3 and list a!! 
differences on the line printer. 

Compare the two files, TRY1 and TRY2, 
both of which are on the disk, and 
list the differences on the printer. 

Return to the Monitor , 

Kill the job, deassign all devices, 
and release core . 
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DIAGNOSTIC MESSAGES 



Table SRCCOM-1 Source Compare Diagnostic Messages 



Message 


Meaninq 


?BUFFER OVERFLOW 


The buffer is not large enough to handle the number 
of lines required for looking ahead. 


?COMMAND ERROR 


Error in last command string entered. 


?FILE 1 READ ERROR 


An error has occurred on the first input device 
specified in the command. 


?fILE 2 READ ERROR 


An error has occurred on the second input device 
specified in the command. 


?INPUT INITIALIZATION ERROR 


One of the input devices cannot be initialized; 
generally, the device either does not exist or has 
been assigned to another job. 


NO ERRORS ENCOUNTERED 


No differences were found between the two source 
files. 


?OUTPUT INITIALIZATION ERROR 


The output device cannot be initialized; generally, 
the device either does not exist or has been as- 
signed to another job. 
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BINARY COMPARE (BINCOM) 



FUNCTION 



To compare, word by word, two versions of a binary 
(.REL) program file and to output any differences. 



I ENVIRONMENT 



Monitor 


All 


Minimum Core 


1 K if output device is other than DTAn:, MTAn:, or DSK:; 
otherwise 2K. 


Additional Core 


See "Minimum Core." 


Equipment 
Required 


Two input devices for the two files to be compared; one output 
device for listing the differences. Both input files can be on 
disk. 
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INITIALIZATION 



R BINCOM^ Loads the B inary Compare routine . 

Binary Compare is ready to receive 

a command « 



COMMANDS 



General Command Format 

list-dev:filename.ext< input! -dev: filename .ext, input2-dev:filename . ext^ 

list-dev: The device on which the differences are to be listed. 

LPT: (line printer) 
TTY: (Teletype) 
MTAn: (magnetic tape) 
DTAn: (DECtape) 
DSK: (disk) 

If !ist-~dev:filename.ext<l— is omitted^ TTY: is assumed. 

input! -dev: The devices on which the two binary files to be 

input2-dev: compared are locoted 

DTAn: (DECtape) 

DSK: (disk) 

CDR: (card reader) 

PTR: (paper tape reader) 

MTAn: (magnetic tape) 



filename. ext (DSK: and DTAn: only) 



The f{ lename and extension of either of the input 
binary files. 

The filename and extension to be assigned to the 
output fist file . 

NOTE: if .ext is omitted, .REL is assumed. 

The output device is separated from the input binary 
file devices by the left arrow symbol . 
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EXAMPLES 



. R BINCOM^ 

* LPT:< DSK:PROGl .REL,DTA1 :PROG1 .REL^ 

NO ERRORS ENCOUNTERED^ 
DTA1:BINA,DTA2:BINB^ 

filel-word file2-word XOR 

• • • 

. KJOB^ 



Compare the binary program file PROGI ,REL In the 
user's area of the disk with a binary program file^ 
PROGI ,REL, on DTA1 , and list all differences on 
the line printer. 

No differences were found between the two files. 

Compare the binary program file BIN A on DTA1 with 
the binary program file BINS on DTA2 and list all 
differences on the Teletype. 

NOTE: .REL is assumed as the extension name for 
both BINA and BINB. 

Return to the Monitor. 

Kilt the job, deassign all devices, and release core. 
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DIAGNOSTIC MESSAGES 



Table B C-1 Binary Compare Dlognosfic Messages 



Message 


Meaning 


?COMMAND ERROR 


Error in last command string entered. 


?END OF FILE PHASE ERROR 


One input file is longer than the other. 


? INPUT INITIALIZATION ERROR 


One of the input devices cannot be initialized; 
generally, either the device does not exist or it 
is assigned to another job. 


NO ERRORS ENCOUNTERED 


No differences were found between the two binary 
program files. 


? OUTPUT INITIALIZATION ERROR 


The output device cannot be initialized; generally, 
either the device does not exist or it is assigned to 
another job. 



Error Differences 

Whenever a difference is encountered between the two files being compared, a line is printed on the 
listing device in the following format. 

filel -word file2-word XOR of both words 
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ALGEBRAIC INTERPRETIVE DIALOGUE (AID) 



FUNCTION 



To provide users with a personal computing service 
for solving complex numerical problems 



ENVIRONMENT 



Monitor 


All 


Minimum Core 


1 1 K (with 1 K of user data area)^ 


Additional Core 


Up to 3K additional (providing a total of 4K 
of user data area) 


Equipment 
Required 


May use DECtape, disk, etc., for filing 
and subsequent recalling of data 



Note that AID will not run in 16K of core if Monitor occupies more than 5K of that core. 
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INITIALIZATION 



.R AID^ 

AID (revision date) AT YOUR SERVICE . . 



Loods the AID program into core 

. ^ AID responds vv^th message when 

Soaded , 

AID is ready fo receive a command. 



COMMANDS 



Format Rules 



step. 



1 . Only one step (command) can be typed per line, and only one line can be used for each 



2. The text of each step begins with a verb and terminates with a period followed by a 
carriage return. 

3. Words, variables (1 -character identifiers), and numerals can neither abut each other nor 
contain imbedded spaces; spaces cannot appear between an identifier (when it appears in an array, a 
formula, or a function) and its associated grouped operators and arguments. Otherwise, spaces can be 
used freely . 

4. Characters can be erased by striking the RUBOUT key once for each erasure; an entire 
line can be deleted by typing an asterisk followed by a carriage return. 

5. A direct step is interpreted and executed by AID immediately (i.e., following the 
terminating carriage return typed by the user). No step number precedes a direct step; the line begins 
with the verb of the command. 

6. An indirect step is entered by preceding the step with a numeric label containing both 
an integer and a decimal portion (e.g., 1 .23); maximum number of significant digits in a step number 
is nine. Indirect steps are organized into parts according to the integer porfion of their step number; 
all indirect steps having the same value in the integral portion of their step number belong to the same 
part. Indirect steps are not executed immediately but are stored for later execution (e.g., by a DO or 
TO command). 
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Identifiers 



Single alphabetic characters (A through Z, a through z) 



Defined by a value 



SET X = value. 
DEMAND X, 



Defined by an expression 

Arithmetic Formulas: 

LET x = arithmetic formula 

Boolean Expressions (Propositions): 

LET x = proposition 



(Set A = 2*5.7.) 
(Demand A. ) 

Let A = sqrt (b>fc/d. 



b = true 

c = false 

Let A ^ b and c. 



User-Defined Function: 

LET X (arguments) = expression 

Indexed identifiers (arrays) 
x(i 1 ,12,13,. . .) 

One to ten indices (subscripts) allowed. 

Each subscript can be in the range -250 through +250, 

SPARSE items in an array: 



Let A(b,c) = bf 2+c^2, 



LET X BE SPARSE, 



Sets all undefined items in array "x" to 0 and 
saves the core which would be occupied by 
those items. 



Arithmetic Operators (listed in order of precedence) 



Standard Designation 


AID Symbology 


Meaning 


|x| 


!x! 


AS value of x 


[ ] 


[ ] 


Is! ouping 


( ) 


( ) 


2nd level grouping 


x« 


x^e 


X raised to the power of e 


a.b, a(b), or a x b 


a*b 


a multiplied by b 


a/b or^ 


o/b 


a divided by b 


a + b 


a+ b 


0 added to b 


a - b 


a -b 


b subtracted from a 


NOTE: Within nested pairs of br 

is from the innermost pair outward. 


ar of evaluGi 
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AID functions 



org (x,y) Computes angle between +x oxis of x^y plane and line joining point 
0,0 and point x^y. Ansv/er is in radians, 

cos(x) Computes cosine of x (x must be in radians and less than 100). 

dp(x) Returns the digit part of x. 

exp(x) Exponential function: e^, where e is Euier's number (2 J 78281 828) 

(e^ must be less than 10^ 00) 

first(i=iterative expression: i proposition) Finds first value in an array to satisfy 
the proposition^ using \ as an index. Result = value of i 

fp(x) Returns the fractional part of x, 

'P(x) Returns the integer part of x. 

log(x) Computes natural log of x (x must be greater than zero). 

max(i=iterative clause: i expression) Computes expression iteratively for each 

value of i and returns largest value. 

max(series) Returns the largest value in the series. 

min(iterative clause: i expression) Computes expression iteratively for each 
o** value of i and returns smallest value. 

min(series) Returns the smallest value in the series. 

prod(i=iterative clause: i expression) Computes expression iteratively for each 

or value of i and returns the product of all the 

computed values. 

prod(series) Returns the product of the series of values . 

sgn(x) Signum function: x > 0, signum = +1; 

X = 0, signum = 0; 
x < 0/ signum = -1 

S'n(x) Computes sine of x (assumed to be in radians; x must be > 0). 

sqrt(x) Computes the square root of x (x must be > 0). 

sum(i=iterative clause: i expression) Computes expression iteratively for each 

value of i and returns the sum of all the 
computed values, 

sum(series) Returns the sum of the series of values. 

tv(proposition) Returns the truth value of the proposition: 

true = 1 

false = 0 

xp(x) Returns the exponent value of x. 
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User-Defined Functions 



f(a,b,c, . . .)= expression 

f function identifier (any single alphabetic character) 

(a,b,c, . . .) dummy arguments; the use of a character as a dummy argument in 
no way affects its use as an identifier. 

expression the arithmetic expression representing the user function. 

Propositions (Boolean Expressions) 

Relational Operators: 

= (equal) ^(not equal) >(greater than) <(less than) 

>= (greater than or equal to) <~ (less than or equal to) 

Logical Operators: and, or 

Negation: not 

* X = true J 

* y = false J 

* Let z = X and y or x and (100 sqrt(959) ).^ 
*Type z.^ 

z = true^ 

Order of Execution: 

(1 ) Evaluation of expressions 

(2) Parentheses (from innermost pair outward) 

(3) Relational operations 

(4) not 

(5) and 

(6) or 

A series of relational operators (a = b>c<d) is assumed to be an and chain (a = b and b>c and 
c<d). 

Conditional Expressions 

Allows an expression to have different values depending upon which one of a number 
of conditions is true , 

A conditional expression is a series of expressions separated by semicolons, with each 
expression preceded by a proposition and a colon. The entire conditional expression 
is enclosed in parentheses (or brackets). 

(proposition: expression; proposition: expression; ) 

Let C(x) = (xX):x ^2; x=0:0; x<0:x). 

states that: 

2 

if x> 0, then C(x) = x 
if X =0, then C(x)= 0 
if x< 0, then C(x) = x 
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If the last expression is to be true for all cases which do not satisfy any of the other 
stated conditions^ the expression can be typed without o preceding pro|x>sitioti. 

Let C(x) = (x> 0:x t 2; x =0:0;x). 

Every possible combination of the variobie must be provided for^ either by explicitly 
stating a proposition ond an expression for it^ or by simply specifying a terminating 
expression to be executed for al! remaining cases » 



Table AID-1 AID Command Summary 



Command Format 


Type 


Description 


CANCEL. 
(CANCEL.) 


D,0 
D,0 


Cancels a currently stopped process when the 
user does not desire to resume execution. 

Cancels a currently stopped process which was 
initiated by a parenthetical DO. 


DELETE ( 


fl ^ 

S 

S(m, n) 
form m 
step m . n 
part m 
formula f 
all steps 
all parts 
all formulas 
all forms 
all values 

U'l J 




O 


Erases the specified item from immediate storage 
and frees the space occupied by it for some other 
use. 

Several DELETE commands can be combined 
into one. 


DEMAND j 


S(m, n) 

L as "any text" 
S(m, n) as "any 
text" 


\ - 


i,o 


Causes AID to type out a message requesting 
the user to supply a value for the specified 
item. Only one variable can be specified 
in each DEMAND command. 


DISCARD ITEM m(code). 


F 


Deletes item *m from the external storage file 
currently in use. (Code) is optional. 


1^ step m. n 

step m. n, p times 
DO J step m.n for L = range V- 
^ part m [ 

part m, p times 
Vw part m for L = range J 

(DO, . . . same as above. . .) 


O 


Executes an indirect step or part. If the DO 
command is a direct step, control returns to 
the user at the completion of the DO; if an 
indirect step, control returns to the step 
following the DO. 

Initiates a new execution without cancelling 
the currently stopped process. 



AID-6 



Table AID-1 (Cent) AID Command Summary 



Command Format 


Type 


Description 


DONE. 


i,o 


Skips execution of the remaining steps of a 
part during the current iteration. 




s 

S(m, n) 
form m 
step m . n 
part m 
formula f 
all steps 
all parts 
all formulas 
all forms 
all values 
all 

L J 


) AS ITEM 
n (code) _^ 


F 


Stores the specified item in the external storage 
file currently open. Immediate storage is not 
affected in any way. (Code) is optional. 


FORM m: 


O 


Defines a format to be used in editing typeouts 
for purposes of readability. 

<«0^<-<-.<-«-0- fixed point notation 

(up to nine digit 
positions plus the 
decimal point) 

(minimum of seven 
positions, maximum 

of Toi irfp>^»n 1 

text any text to be included 

in the line; not enclosed 
in quotation marks unless 

thpv nrp nart of thp tf»yt 


GO. 


D,0 


Continues execution of a currently stopped 
process; opposite of the CANCEL command. 


IF Clause 

Verb. . . .IF proposition. 


M 


Can be appended to any command (except the 
abbreviated SET command) to make the command 
conditional; the command is executed only if 
the proposition is true. 


LET < 


rL=m 
1 L = formula 
1 F(L)=m 1 
F(L) = proposition 




O 


Defines arithmetic formulas. Boolean expressions 
(propositions), and user functions and associates 
them with identifiers. The formula, expression, 
or function with which an identifier is associated 
is re-evaluated each time the identifier appears 
during an execution. 
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Table AID-1 (Cont) AID Command Summary 



Commond Format 


Type 


Description 


LET S be sparse . 


S 


Sets undefined array elements to zero. 


LINE. 


O 


Advances the Teletype paper form one line. 


PAGE . 


O 


Advances the Teletype paper form to the top 
of the next page. 


QUIT . 


O 


Skips execution of the remaining steps of a 
part and satisfies the DO command for that 
part by cancelling any further iterations, 
usually given conainonaiiy . 


RECALL ITEM m (code) . 


F 


Reads an item, previously stored by a FILE 
command, from the currently open external 
storage file into immediate storage. (Code) 
is optional and is for documentation only. 


RESET TIMER. 


S 


Resets TIMER to zero. 


SET i 


' L = proposition , 

S{m,n)=m 
^S(m,n)= proposition 




O 


Defines an identifier as equivalent to a fixed 
value, which is calculated once and then used 
whenever the identifier appears. A short form 
ot the bbl command, where the word SET and 
the period are omitted, can be used if the 
command is direct. 


STOP. 


i,o 


Temporarily halts the current process at the 
point where the STOP command appears and 
returns control to the user. The stopped 
process can be resumed by typing GO. 


TO fP°'"^ '] J. 
1 step m.n j 


i,o 


Discontinues the sequential execution of the 
part currently being executed and transfers 
control to another step or part; when the new 
part is finished, the direct command which 
initiated the execution is satisfied. 
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Table AID-1 (Cont) AID Command Summary 



Command Format 


Type 


Description 


f m 

S 

S(m, n) 
proposition 
"any text" 
<- 

form m 
step m. n 
part m 
formula f 
F(x) 

J F (proposition) 
TYPE \ all steps 
all parts 
all formulas 
all forms 
all values 
all 
time 
timer 
size 

item-list ^ 




O 

S 
S 

s 

F 


Types out the specified information on the 
user's console. Several individual TYPE 
commands may be combined into one (except 
for TYPE "any text" or TYPE ITEM-LIST). 

The command 

Type ... in form n. 

causes the listed items to be typed out in the 
format specified by form n. n can be a numeric 
value (e.g.. Form 3) or it can be a numeric 
formula (e.g.. Form (2*x-y) ). 


USE FILE filename (device) - 


F 


Makes an external storage file available for 
use. The external file thus addressed remains 
open for use (by DISCARD, FILE, RECALL, and 
TYPE ITEM-LIST commands) until another USE 
command is given or the AID program is termin- 
ated. 


Command Format Symbology 
L = letter 

S = subscripted letter 
m, n, p = numeric values 
f = formula 
F = function 

range = an iterative sequence or series of values 

Type Symbology 

D = Can be given directly only 
I = Can be given indirectly only 
O = Operational command 
F = File command 
S - Special command 
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Table AID-2 File Command Subset 



Command Format 


Section 
Reference ^ 


Description 


DISCARD ITEM m (code) 


5.4 


Deletes item ^m from the external storage file 






currently in use. (Code) is optional. 


FILE ^ 


L 

S 

S(m, n) 
form m 
step m. n 
part m 
formula f 
all steps 
all parts 
all formulas 
all forms 
all values 
all 


AS 

I ITEM 
n (code) . 


5.7 


Stores the specified item in the external 
storage file currently open. Immediate 
storage is not affected in any way. (Code) 
is optional . 


RECALL ITEM m (code) 




5.15 


Reads item ^m, previously stored by a FILE 
command, from the currently open external 
storage file into immediate storage. (Code) 
is optional and is for documentation only. 






TYPE ITEM-LIST. 


5.20 


Obtains a typeout of the directory of the 
currently open external storage file. 


USE FILE filename (device) 


5.21 


Makes an external storage file available for 
use. The external storage file thus addressed 
remains open for use (by DISCARD, FILE, 
RECALL, and TYPE ITEM-LIST commands) until 
another USE command is given or the AID 
program is terminated. 



Section references refer to sections within the PDP-1 0 AID (Algebraic Interpretative Dialogue) 
Programmer's Reference Manual, DEC-1 0-AJAO-D. 
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Table AID-3 AID Character Set 



Standard 




Typing Method 


JOSS 
Symbol 




Math 
Symbol 


AID Symbol 


Model 


Models 33 and 35 


Notes 




A through Z 


Strike aoDrooriate 
key with SHIFT. 


Strike appropriate 
key; no SHIFT. 


A through Z 






a through z 


Strike appropriate 
key without SHIFT 


Not avai lable; 
use upper-case 
letters . 


a through z 






0,1 through 9 


Strike appropriate 
key; no SHIFT. 


Strike appropriate 
key; no SHIFT 


0,1 through 9 




Operators: 
1 1 (absolute) 


1 1 

! ! 


Strike the ! ,1 
key with SHIFT. 


Strike the !,1 
key with SHIFT. 


1 1 




[ ] (brackets) 


[ ] 


^ItiI^o nr\r\rr\r\rt rti^e^ 

keys . 


f Strike K with 

SHIFT 
] Strike M with 
SHIFT 


[ ] 




V ) (parentheses) 


\ ) 




( Strike the (,8 
key with SHIFT. 

) Strike the) ,9 
key with SHIFT . 


\ ) 




X® (exponent) 


x^e 




Strike the N,^ 
key with SHIFT 


ie 




/ (divide) 


/ 




Strike the ?,/ 
key; no SHIFT. 


/ 




. (multiplication) 


* 




Strike the *,: 
key with SHIFT. 


• 




+ (addition) 


+ 




Strike the +,; 
key with SHIFT. 


+ 




- (subtraction) 






Strike the =,- 
key; no SHIFT. 






Boolean 
Expressions: 

= (equal) 






Strike the =, - 
key with SHIFT . 






7^ (not equal) 


# 




Strike the #,3 
key with SHIFT. 
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Table AID-3 (Cont) AID Character Set 



Standard 

/Viarn 
Symbol 




Typing Method 


JOSS 
Symbol 




AID Symbol 


Model 37' 


Models 33 and 35 


Notes 


< (equal to or less 
> than) 


j< =(2 characters) 




Strike the<, .key 

'iL CUTCT. 

With oMlr 1 ; then 
strike the =,-key 
with SHIFT. 


< 




> (equal to or 
greater than) 


> =(2 characters) 




Strike the >, . 
key with SHIFT; 
then strike the 
= , - key with 
SHIFT. 


> 






RUBOUT (types 
back as \ ) 


Strike DELETE 
key to erase 
each preceding 
character in 
error; then type 
correctly , 

Example: 

TPE \\YPE 
PART 1 . 


Strike RUBOUT 
key to erase each 
preceding char- 
acter in error; 
then type 
correctly . 


BACK- 
SPACE and 
type over 


Used to 
correct 
typing 
errors . 


null item 






btrike 0 key 
with SHIFT. 


(underscore) 






$ (current line 
number) 


Strike the $,4 
key with SHIFT 


Strike the $,4 
key with SHIFT. 


$ 






* (cancel 
entire line) 




Strike the *,: 
key with SHIFT. 


* 





Blank boxes in this column represent characters whose keyboard positions have not yet been determined. 
This information will be supplied at a later date. 
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EXAMPLES 



I . Estimation of the square root (xj) of a positive number (A) by tiie iterative formula: 

= i(x. + ^ ) until A - (x. )^ < some "permitted deviation" value 



. R AIDii 

AID (1-30-68) AT YOUR SERVICE . . . tl 
*1 .1 Demand A.(i 

* 1 .15 Type "GIVE ESTIMATION".^ 
*1 .2 Demand X. d 

*1.3 Set N= ( i )*(X + A/X).f/ 

* 1.4 To part 2 if !A-(X^2) !>. 00001 ./^ 
*1 .5 Type A,X in form 1 .f} 



*1.6TypeX, X ^ 2 in form 2.(/ 
*2.1 Set X = H.ii 
*2.2 To step 1 .3.ti 
*Form 1 :^ 

*THE SQUARE ROOT OF<khm-<-3- IS <K»<-.o-<»<-<KK-,} 
*Form 2: d 

* PROOF: <KK>-<J-<KKJ-*0- SQUARED IS <»0-<Kh- O-SKKJKJ-O-^ 
*Do part 1 , 4 times. 

A= *\02ti 
GIVE ESTIMATION/^ 

X= *12^ 

THE SQUARE ROOT OF 102.00 IS 10.099505/;^ 
PROOF: 10.099505 SQUARED IS 102.000001/^ 

A= *133.39^ 
GIVE ESTIMATION/^ 

X= *11.1t^ 

THE SQUARE ROOT OF 133.39 IS 1 1 .549459/^ 
PROOF: 11.549459 SQUARED IS 133.390001^ 



"A" is the positive value for which the square 
root is to be calculated. 



"X" is an estimated square root . 

This is the given formula (above) expressed in 
the AID language . 

Go to port 2 if the difference between the square 
root of the estimated square root and the actual 
number is greater than .00001 . 

The difference is equal to or less than .00001 ; 
type the two values, A and X. 

Type the "proof" statement. 

Set the value of X for the next iteration. 

Return to recalculate. 

Set up forms for typing out results. 
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A=*i234.55ti 

GIVE ESTIMATION 

THE SQUARE ROOT OF 1234.55 IS 35.136164(^ 
PROOF: 35.136164 SQUARED IS 1 234 . 550000 

GIVE ESTIMATION,^ 

X= *2ti 

THE SQUARE ROOT OF 5.00 IS 2.236068^ 

PROOF: 2 .236068 SQUARED IS 5.000000/^ 

* 

2 . Generation of Sine Wave 

*1 .1 Do part 2 for I = 1 (6*3) 3 60*1 .5.^ 

*2.1 SetX=I.^ 
*2.2 Do part 3.^ 
*2.3 Do part 4.^ 

*3.01 Set X = X/57. 2957795. ti 

*3.02 SetA=1.^ 

*3.03 SetC-3.^ 

*3.04 SetS^O.d 

*3.05 SetG=1.^ 

*3.06 SetY=X.^ 

*3.07 To step 3.50 if (X-2*3. 141 59) <0.^ 

*3.08 Set X= X -6.283191.^ 

*3.09 To step 3.06^ 

*3.10 SetY = Y*X*X.^ 

*3.20 Set A = A*C*(C-1).^ 

*3.30 SetC = C+2.ti 

*3.40 Set G=-G. li 

*3.50 Set T= S+ G * Y/A.f/ 

*3.60 To step 3.90 if (T-S)= 0. 

*3.70 SetS^T.^ 

*3.80 To step 3.10. 

*3.90 Done.^ 

*4.1 Type M in form IP ( (12 + 10*S) +1).^ 
*Form 1 : ^ 

*Form 2:^ 

*Form 3:iJ 

•k 
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Generation of Sine Wave (cont) 



*Form 4:tl 
*Form 5:^ 



*Form 6: 

* 

*Form 7:^ 



*Form 8:^ 
* 

*Form 9:^ 
Form 10: 
Form 11:^ 
*Form 12:^ 
*Form 13:(f 

* 

*Form 14: 
* 

Form 1 5:^ 
Form 16:^^ 
Form 17:^ 
Form 18:/i 
Form 19:(^ 
Form 20:^ 
Form 21 :^ 
Form 22 
*Form 23:^ 
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Generation of Sine Wave (cont) 

*Form 24: ^ 
* 

*Form 25: ^ 

*Form 26:^ 
* 

*M = 8^ 

* Do part 1 . ^ 



8 
8 
8 



8 
8 
8 



8 
8 
8 



AID-16 



Table AID-4 AID Diagnostic Messages 





Meaning 


X = ??? 


Ail I 1 I* 1 1 1.1 r 

A value has not been supplied by the user tor 




variable x. 


DONE. 


Signals completion of a File command (DISCARD, 


Tat "\ 


FILE, RECALL). 


DONE. I'M READY TO GO < FROM > STEP m .n . 


. . .AT STEP m.n.. .Task was suspended by an 


UN J 


interruption or error during 




the interpretation of an 




indirect step . 




. . .FROM STEP m .n . . .Task was suspended by a 




stopping command. 




. . .IN STEP m .n . . .Task was suspended during an 




indirectly initiated D(J 




command . 




AID resumes execution whenever the user types 


Tat ^ 


GO. 


DONE. PM READY TO GO ( FROM > 


Same as above, except that the step at which 


1 IN J 


AID is prepared to resume can no longer be found 


STEP m.n, ALTHO I CAN'T FIND IT. 


in immediate storage. Possibly, a direct com- 


mand (or a routine initiated by a parenthetical 




DO) has deleted the step in the interim. Upon 




receipt of a GO command from the user, AID will 




airempT to resume ar irie diep luiiuvviiiy mc iiiioo 


j DIRECTLY 1 


ing step . 


nOKI'T ^T\/C TUTC r^KAKA A K\r^ / \ 
UvJN 1 Kjlvt inlo v«^/V\/V\AiNU\ ? 


inis commana can ue given oriiy iriuiiev^iiy yiw. 


1 INDIRECTLY J 


DONE, STOP, DEMAND) or only directly 




(CANCEL, GO). 


EH ? 


The previously entered line is incorrect. 




Indirect commands: The step number was 




incorrecTiy rypea . 




Direct LET commands: LET x portion is 




1 ncorrecr • 




Other direct commands: A space was omitted . 




1 ne lerminaiing 




period was omitted. 




The command is not 




legitimate . 




An expression is in- 




correctly written . 




To continue, retype the command correctly. 
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Table AID-4 (Cont) AID Diagnostic Messages 



Message 
ERROR AT STEP m.n: EH? 



ERROR AT STEP m.n: 

fsTEP 

I CAN'T FIND THE REQUIRED/' FORM 

] PART 

Lformulaj 

ERROR AT STEP m.n: (IN FORMULA x): 



z = ??? 



ERROR IN FORMULA x: EH? 



FIL£ NUMBER MUST BE POSITIVE 
INTEGER< = 2750 

FORM NUMBER MUST BE INTEGER AND 
1< = FORM<10^9. 

I CAN'T EXPRESS THE VALUE IN YOUR FORM. 



FORM^ 

I CAN'T FIND THE REQUIRED I ITEM \ 

PART I 
.STEP J 



Meaning 

The step number is correct, but the command is 
incorrect . 

a . Request a typeout of the step in error. 

b . Check for the errors listed under "Eh ?" . 

c . Retype the command correctly. 

d . Type GO . to continue . 

The step in error refers to a nonexistent step or 
part . 

Correct the error and type GO . to continue. 



The variable z has not been assigned a value by 
the user . 

Check for any other errors, define variable z 
correctly, and type GO . to continue. 

(Following a direct command in which x was 
used) The form of the expression for x is in error. 

a . Request a typeout of formula x . 

b. Check for the errors listed under "Eh ?" . 

c . Formula x may be correctly written, but the 
definition of one or more identifiers is not 
consistent with their use in formula x. 

The fi lename of a USE command must not be 
greater than the value 2750. 

Form numbers must be integers in the range 1 
through lO'- 1 . 

A value cannot be expressed in the format speci- 
fied by the FORM (e.g . , the value is too large to 
specify in fixed point notation). To correct, 
follow the steps given under "I HAVE TOO 
MANY VALUES FOR THE FORM." 

Either the element has never been defined or has 
been deleted . 
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Table AID-4 (ConI-) AID Diagnostic Messages 



Message 

I CAN'T MAKE OUT YOUR FIELDS IN THE 
FORM. 

I HAVE AN ARGUMENT< = 0 FOR LOG. 

I HAVE A NEGATIVE ARGUMENT FOR SORT . 

I HAVE A NEGATIVE BASE TO A FRACTIONAL 
POWER. 

I HAVE AN OVERFLOW . 

I HAVE A ZERO DIVISOR. 
I HAVE NOTHING TO DO . 

I HAVE TOO FEW VALUES . 

I HAVE TOO MANY VALUES FOR THE FORM. 



I HAVE ZERO TO A NEGATIVE POWER. 
ILLEGAL SET OF VALUES FOR ITERATION. 

I'M AT STEP m.n. 



Meaning 

The fields in the form specified were typed in 
such a way that AID cannot distinguish their be- 
ginning or ending. Possibly, there are either no 
fields in the form or two or more are run together 
with no intervening space. 

The argument for the LOG function must be 
greater than 0 . 

Square root arguments must be positive. 

An attempt was made to raise a negative value to 
a fractional power. For example. 

Type (-y)^ (1/2). 

Some number has exceeded 9.99999999.10 ^ 99 
in magnitude . 

An attempt was made to divide by 0. 

The user has typed GO . , but there is no currently 
stopped process which can be continued. 

An insufficient number of arguments have been 
supplied for a function. 

There are not enough fields in the form to receive 
all the values to be typed. 

a . Type the form and the values . 

b . Check for errors . 

c . Change either the TYPE command or the 
FORM to make them compatible and then 
type GO . to continue. 

An attempt was made to raise 0 to a negative 
power . 

An error has been detected in a range clause of 
a function or a DO command, such that the end- 
ing value can never be reached (e .g . , the incre- 
ment is 0) . 

When the user responds to a DEMAND-produced 
request (x=*) with a carriage return only, AID 
types back this message. 
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Table AID-4 (Conf) 



AID Diagnostic Messages 



Message 

INDEX VALUE MUST BE INTEGER AND 
! INDEX! < 250 

I NEED INDIVIDUAL VALUES FOR A FORM 



I RAN OUT OF SPACE. 



I RAN OUT OF FILE SPACE. 
ITEM NUMBER MUST BE =25. 



NUMBER-OF-TIMES MUST BE INTEGER AND 
>=0. 

PART NUMBER MUST BE INTEGER AND 
1< = PART 10 ^ 9. 

PLEASE DELETE THE ITEM OR USE A NEW 
ITEM NUMBER. 



PLEASE KEEP !X!< 100 FOR SIN(X) AND 
COS(X). 

PLEASE LIMIT ID'S TO 5 LETTERS AND/OR 
DIGITS. 



Meaning 



All index values (subscripts) must be integral and 
must have an absolute value of < 250. 

A command was given to type a subscripted vari- 
able in a form (e.g.. Type B in form 1, where 
B is a subscripted variable) . Individual values 

only can be specified for TYPE IN FORM n 

commands . 

User's immediate memory is filled due to one of 
the following errors. 

a . Endless loops because of DO commands or 
because DO was typed instead of TO. 

b. Unlimited recursive definition. 

c . Variable x defined in terms of y , and vari- 
able y defined in terms of x via LET com- 
and . 

d. Program is too large for available memory; 
use TYPE SIZE command to determine how 
much immediate storage has been used. 
File commands can be used to store parts of 
the routine and execute them one at a time. 

DECtape directory is full (limit = 22 items) . 

The item number in file commands (DISCARD, 
FILE, RECALL) must be less than or equal to 25 
(22 for DECtapes) . 

The value specified in the TIMES clause of a DO 
command must be a positive integer. 

Part numbers must be integers and in the range 
1 through 10^-1. 

The user has attempted to FILE information into an 
item which already exists on the currently open 
external storage file. The user must either 
DISCARD the item prior to filing the new infor- 
mation or use a different item number in the FILE 
command . 

Arguments for the SINE and COSINE functions 
must be less than 100. 

Filename in a USE file command or code in a 
DISCARD, FILE, or RECALL command exceeds 
five characters in length or contains special 
characters . 
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Table AID-4 (Cont) AID Diagnostic Messages 



Message 

PLEASE LIMIT LINES TO 78 UNITS (CHECK 
MARGIN STOPS) SAY AGAIN: 

PLEASE LIMIT NUMBERS TO 9 SIGNIFICANT 
DIGITS. 

PLEASE LIMIT NUMBER OF INDICES TO 10. 

PLEASE LIMIT NUMBER OF PARAMETERS TO 
TEN 

PLEASE LIMIT STEP LABELS TO 9 SIGNFICANT 
DIGITS. 

REVOKED . I RAN OUT OF SPACE . 
ROGER. 

SOMETHING'S WRONG . I CAN'T ACCESS 
THE FILES. 

SOMETHING'S WRONG. TRY AGAIN. 
SORRY. SAY AGAIN: 



STEP NUMBER MUST SATISFY 
1<=STEP<10^9. 

STOPPED BY STEP m.n. 

YOU HAVEN'T TOLD ME WHAT FILE TO USE. 



Meaning 



User typeins are limited to single-line, 
78-character strings . 

Numeric values are limited to nine significant 
digits. 

The number of subscripts following on identifier 
cannot exceed 10. 

The number of arguments for a function is limited 
to 10. 

Step numbers can be up to nine digits in length . 

See "I RAN OUT OF SPACE." 

Signals successful completion of a USE file 
command . 

A system I/O error (or other type of AID error) 
has occurred . Begin again . 

AID has found something unusual in its internal 
records or has received contradictory signals from 
its I/O routine . Begin again. 

A transmission error occurred on the previous 
typein. This message is preceded by the erroneous 
line with ^ symbols typed where the failure 
occurred. Retype the line . 

Step numbers must be in the range 1 through 10 -1 . 

Process has been. temporari ly halted by a STOP 
command at step m .n . 

The user has issued a DISCARD, FILE, RECALL, 
or TYPE ITEM-LIST command before he has given 
a USE file command. 
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DESK CALCUUTOR (DESK) 



FUNCTION 

To give the user direct access to arithmetic functions 
for problem solving. 

• A powerful conversational problem-solving 
system 

• No complex programming rules to follow; prob- 
lems are entered by use of familiar arithmetic 
operators and functions 

• Permits the user to define new macro operations 
for those functions not contained in the basic 
repertoire 



ENVIRONMENT 



Monitor 


All 


Minimum Core 


4K (no macros) or 5K^ 


Additional Core 


None 


Equipment Required 


Console Teletype; other devices are optional . 



DESK can be run in 4K only if no macro definitions ($D) are used; otherwise 5K is required. 
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Loads the Desk Calculator program 
into core . 

The Desk Calculator is ready to receive 
the first problem statement. 



Table DESK-1 . Desk Pseudo-Commands 



Command 


Operation 


$C 


Clear l"he accumufotor. 


$Dfunctlonname (2 or 3 char.) 


e macro routine , 


$Kfunctionname 


Delete the function specified by the user. 
!f no function is specified^ delete all 
user functions and set all variables to - 


$G a 


Get the value assigned to the symbol 
"a«" If none is assigned^ the value 0 is 
assumed . 


$L 


Output line (carnage re rum roUowed by 
Sine feed)* Used in macro operotions„ 


$Pa 


Place a value into ''a 


$T 


Output tab» Used in macro operation... . 


$Fn (0<n<7) 


Round output to n significant digits. 


$1 


fxound output to nearest integer (same 
$F0). 


$R 


Secondary exit from a macro ODeration = 



INITIALIZATION 



.R DESK 



•a 



COMMANDS 
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Table DESK-2 Desk Functions 



Function 


L/escr 1 pTion 


ATN 




arc tangent in radians 


COS 




cosine in radians 


CSD 




cosine in degrees 


FYP 
CAT 




exponential (n ) 


LOG 




! (vj i u 1 vJ i ! vjy vJ 1 i f I If 11 \ L \J /\ / 


SIN 




sine in radians 


SND 




sine in degrees 


XNT 




integer part {i.e», truncate fioating point 
number so that only a floating point integer 

remains) 
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Table DESK-3 Desk Command String Symbols 





Pi I 1 1 

1 Ul 1 i\J\ I 


< — 


Directs Desk to output the value of the ex- 
pression . 




Delimits the macro mnemonic and also delimits 
the instruction string which constitutes the macro 
function , 


1 


Directs Desk to output the expression value 
fol lowed by a tab . 


ML 1 /V\v-/L-'L Key 


Directs Desk to evaluate the expression and 
type the output on the same line. 


Arguments 


A rrKiximum of nine arguments can be specified 
within CI iTKicro function in the form 

macro- mnemonic (A, , A^, A ) 

^ 1 Z n 

Arguments are written in the form ^n (]< n< 9) 


Arithmetic Operators 


Add + 
Subtract 

Multiply * 
Divide / 
Raise to ^ 
the power 

Parentheses ( ) 

for grouping 

subexpressions 
Replacement; = 

cf-nrp the 

expression 

on the left 

in the variable 

on the right 


Comments 


Comments are enclosed within quotation 
marks . 


Labels 


Labels within macro functions can consist 

of two or three digits followed by a colon (:). 


Macro Mnemonics 


Macro mnemonics can consist of two or three 

alphabetic characters. 
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Table DESK-3 (cont) Desk Command String Symbols 



Symbol 


Function 


Transfers Within Macro Statements 


] 

STP 


Transfer if result of sub- 
tracting one from the first 
argument is greater than 
zero , 




Ta2 


Transfer unconditional. 




Tc 


Transfer if equal to zero. 




TG 


Transfer if greater than zero. 




TGE 


Transfer if greater than or 
equal to zero. 




TL 


Transfer if less than zero . 




TLE 


Transfer If less than or equal 
to zero. 




TN 


Transfer if not equal to 


Variables 


Single alphabetic characters are used to re- 
present variables . Variables are actually 
single memory locations, the contents of 

which moy vary. 


NOTES: 1 . The first argument is a 


variable and the second is a label . 


2 . The only argument is a label , 




For all others, the first argument is an expression and the second is a lobe! . 
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EXAMPLES 



.R DESK^ 
$F5^ 



S IN (1 0) <— (ALTMODO O , 54402^ 
$F3^ 

COS (10)<-^ 
0.839^ 



Round ail results to the first five significant decimal 
positions . 

Compute the sine (in radians) of 10 and type the re- 
sult on the same line. 

Round all results to the first three significant deci- 
mal positions. 

Compute the cosine (in radians) of 10 and type the 
result on the next line. 



$DCMP;^ 

$F1X!y!X+Y!X^2+Y^2<J— ;^ 



CMP (4,6)^ 

4.0 6.0 10.0 52.0^ 



Define a macro operation called CMP. 

The first argument entered whenever CMP is used is 
represented in the formula by X . 

The second argument entered whenever CMP is used 
is represented in the formula by Y. 

Each time CMP is used, print the following values 
rounded to the first significant decimal position: 

X 

Y 

- X+Y 

2 2 

X +Y 

To use macro routine, type the macro mnemonic 
followed by the arguments within parentheses. 

Values are typed out. 

X Y X+Y X^+Y^ 



$DTYP;^ 

"X SINX COSX"^ 

#1=X^ 
#2=yP 



Define a macro operation called TYP» 
Step 1 . Print a columnar heading « 
2« Perform a line feed. 

3« Argument 1 is represented in the formula 
as X« 

4. Argument 2 is represented in the formula 
OS Y. 
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1 :$F1X !$F5SND(X) !CSD(X) ! $L 



5. tagl: 



X+#3=X^ 

TGE(Y-X,l)<i— ; ^ 



6. 



7. 



Print out the value of X (accurate to 

the first significant decimal position) 

followed by a tab; 

Print out the value of SND(X) - 

accurate to the first five significant 

decimal positions - follov\^ed by a 

tab; 

Print out the value of CSD (X) - 
accurate to the first five significant 
decimal positions - followed by a tab; 
Perform a line feed. 

Increment the current value of X by 
the third argument to produce a new 
value of X . 

If the second argument minus the new 
value of X is equal to or greater than 
zero, go back to tag 1 : - otherwise, 
exit from the routine. 



TYP (10,60,10)^ 



X 

10.0 
20.0 
30.0 
40.0 
50.0 
60.0 



. KJOB^ 



SINX 

0.17365 

0.34202 

0.50000 

0.64279 

0.76604 

0.86603 



COSX^ 

0.98481^ 

0.93969^ 

0. 86603^ 

0.76604^ 

0.6427^ 

0.50000^ 



To use the routine, type the macro mnemonic, 
followed by the three arguments in parentheses. 



Return to Monitor . 

Kill the job, release core. 
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DESK INPUT/OUTPUT COMMANDS 






Table DESK-4 


Desk Input/Output Commands 


Command 


Meaning 


$Ooutpuf-dev:fi lename . ext 


Assign Dutput--dev: and filename «ext (if DTAn or 
DSK) for all output (results and macro definitions) 
from Desk, 


$Sinput-dev: filename. ext 




Assign input»»dev: and filename. ext (if DTAn: or 
DSK:) as source of oil mocro definitions not pre- 
sently existing m core^ 

Example: If user types in a command in the form of 
a macro call^ core is first searched for the macro 
routine definition; if not founds the assigned mpvf 
device is searched . 


$W 


Write out on the selected output device oil macro 
definitions currently active (i.e*^ not killed) in 
core ^ 


$Y 


.'once! the current output device and reossiqn the 
" type for all ovf put 


Example 






.R DESK^ 
$ODSK:SAVE^ 

$DCMP;^ 

$F1X! y!X+y!X^2+Y^2<— ;^ 




Assign a file coiled SAVE on disk for ail Desk out- 
put. 

Define the rrwcro CMP* 


CMP (4,6)^ 
$KCMP^ 




XA/ritP nil fT\ncrf\ rT%?«f?noc r*! srror\f 1 ^/ try # /t ^ 

CMP) on the assigned output device^ 

Execute CMP. Results ore written on the assigned 
output device instead of being typed « 

Delete the CMP routine from core„ 


$SDSK:SAVE^ 




NOTE: It still exists on the output device. 

Select the file called SAVE on the disk as the 
source of oil macro routine definitions 

NOTE: All macro definitions written on an output 
device remain there unfll the file is deleted or other"- 
wise destroyed and can be used any time Desk is run 
without the necessity of redefining the macro 
routine. 
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CMP(5,8)^ 



$Y^ 

CMP (3,9)^ 

3.0 9.0 12.0 90.0^ 
.KJOB^ 



Core is searched for the CMP routine (it has been 
killed and no longer exists in core); the selected 
file on the input device (DSK:SAVE) is then searched, 
CMP is found and brought into core for execution, 
p are written on the selected output device, 

selected output device. 

Seoi cn ih executed as explained in the previous 
e^n-nole. Since the output device has been can- 
rhe results are printed on the Teletype. 

ol to the Monitor. 

assign all devices, and release core. 
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DIAGNOSTIC MESSAGES 



Table DESK-5 Desk DiagnosHc Messages 



Message 


Meaning 


7DEVICE NOT AVAILABLE 


uiiiicri *-4cvi^t; u vJCo iivji tJAioF \ji IT iiQd DCcri Q5SIQn6Q 

fo another job. 


7DIRECTORY CAPACITY EXCEEDED 


DECtape or disk directory is full. 


EVALUATOR UNABLE TO DECIPHER THIS 


An illegal formula (macro definition, etc.) or an 
illegal character has been entered. 


7FILE NOT FOUND 


The filename. ext specified as the input source can- 
not be found on the device. 


FUNCTION EXPECTS ARGUMENT LIST 


Required arguments are missing for the last function 
specified . 


ILLEGAL FUNCTION DEFINITION 


An illegal format has been entered. 


IMPROPER DUMMY SYMBOL 


M symooi nas nor oeen assignea or usea properly. 


IMPROPERLY FORMED ARGUMENT LIST 


Desk expected a list of arguments but found con- 
stants mixpd in 


IMPROPER NAME IN LEFT HALF 


Desk expected an argument name in the left half 

of n WOrH Klif roiinrl comof n i r»n olc£^ 
KJi <J yvKJl yj UKJ I K^UllLI oL/l i Ic^ 1 i 1 1 i lU C i oc^ . 


IMPROPER PARENTHESES COUNT 


number of right parentheses. 


7INTERNAL ERROR 


Mn error nas oeen maae Dy uesK. Kestart rrom be- 
ginning. 


entry IS AN ILLEGAL CHARACTER 


A character cannot be interpreted as a variable, 
operator, or pseudo-op. 


entry IS AN ILLEGAL FIELD SIZE 


Size of field exceeds expected number of decimal 
positions . 


entry IS AN ILLEGAL FUNCTION NAME 


Entry has not previously been defined as a function. 


entry IS AN ILLEGAL PSEUDO-OP 


A $x entry, where x is other than C, D, Fn, G, I, 
K, L, O, P, R, S, T, W, or Y, is unrecognizable. 


7PUSHDOWN OVERFLOW 


The pushdown list in Desk has overflowed. 


UNDEFINED LABEL IN A TRANSFER 


A label appearing in a transfer statement (STP or 
Txx) is not defined elsewhere in the routine. 


VARIABLE NAME IN RIGHT HALF INCORRECT 


Desk expects a variable in the right half of an ex- 
pression but instead finds a constant. 
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BATCH PROCESSOR (BATCH) 



FUNCTION 



To supervise the sequential execution of a series of 
jobs with a minimum of operator attention , 

• Operates as one of the "users" of the system in 
a time-sharing evnironment 

• Maintains constant communication with the 
operator and allows him at any time to interrupt, 
skip, repeat, or prematurely terminate one or 
more of the jobs in the series 

• Runs concurrently with the Batch-controlled 
object jobs 



I ENVIRONMENT 



Monitor 


All 


Minimum Core 


3K 


Additional Core 


Sufficient core to run the Batch-controlled jobs. 


Equipment Required 


One Batch input device, one Batch output device, one 
scratch device, and the shared SYS device. If on 
disk, all of these may be the same device. 
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INITIALIZATION 



.ASSIGN dev BPTEMP^ 
-R BATCH^ 



The logical name BPTEMP (scratch device) must be 
assigned to a retrievabie device (DSK, DTAn, MTAn) 
before beginning Botch. 

Loads the Botch Processor irrto core. 

Indicates that Batch is ready to receive a command. 

NOTES: I . Batch is alvvoys ready to receive a 

command, whether or not an asterisk 
has previously been typed. However^ 
when on asterisk does appear, Botch is 
specifically requesting a command and 
will not proceed without one. 



2. 



f C must never be typed except im- 
mediately following on asterisk type- 
out . 
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COMMANDS 



Batch Input, Batch Output Device Assignments 

INPUT devr.ext Specifies the Batch input device (e,g,, the device 

containing the job control file produced by Stack). 



Can be 




CDR: 


(card reader) 


MTAn: 


(magnetic tape) 


DTAn: 


(DECtape) 


DSK: 


(disk) 


PTR: 


(paper tape reader) 


TTYn: 


(Teletype - NOTE: Operator's 




line number cannot be " n . ") 


(DSK: 


and DTAn: only) 


The 


file. 



Each user^s job is assumed to be a separate 
file with the name IJOBxy .ext, where xy is 
in the range of 01 through 99. If Stack was 
used to create the files, filename . ext's of 
this format were automatically assigned to 
the files in a sequential manner. 



OUTPUT dev:.ext Specifies the Batch output device (i.e., the listing 

device) . 



Can be 




LPT: 


(line printer) 


DTAn: 


(DECtape) 


MTAn: 


(magnetic tape) 


DSK: 


(disk) 


FTP: 


(paper tape punch) 


TTYn: 


(Teletype - NOTE: Operator's 




line number cannot be "n.") 



.ext (DSK: and DTAn: only) 

The extension to be assigned to the output 
files. Batch automatically assigns the name 
OJOBxy .ext, where xy in the range 01 
through 99, to each output file in a sequen- 
tial manner. In any case, .ext is optional . 



NOTE: If either or both of the above commands are typed while a user's job is being processed by 

Batch, Batch stores them until the user^s current job is completed. Batch then takes its next 
input or writes its next output on the most recently specified devices. 
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Job Control Commands 



Execute the nth job on the Botch input device* 
The first Job control command to Batch is normally 
SKIP 0 

Cue., no jobs are skipped and execution begins with 
the first job). 

Once Batch processing has begun, the SKIP commnod 
has the following effects. 

SKIP 0 Restart the current iob. 

SKIP n After the currenf job is finished, ex- 

ecute the nth job after the current job. 

SKIP -n After the current job is finished, ex- 

ecute the nth Job prior to the current 
one (i.e., repeat the previous n job 
executions). 



SKIP n^ 



The following commands can be issued at any point after Batch job execution has been started 
by the first SKIP command. Once Batch has been started, automatic sequential execution of 
the jobs on the Batch input device is performed unless the operator intervenes. 



BREAK^ Finish the current job and halt before continuing on 

* to the next job. The operator must then enter a com- 

mand before Batch continues processing. 

CONTINUE^ Resume processing at point where Botch was interrupted, 

If Batch was doing nothing when interrupted. Batch 
responds with an asterisk; the operator must then type 
a SKIP command to continue. CONTINUE is used to 
resume processing after the user has responded to one 
of the Batch operational messages (see Table BATCH-] ). 

DUMP^ Output o core dump of the current job on the Batch 

output device . This command can be issued at any 
time. Batch automatically continues at the next job. 

EFOUT^ Write an end-of-file on the Batch output device. 

Batch responds by typing "SPECIFY NEW OUTPUT 
DEVICE" followed by an asterisk . The operator must 
then type an "OUTPUT dev:.ext" command followed 
by a CONTINUE command. 

^'^'^ti Terminate the current job immediately. 
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I EXAMPLES I 



.ASSIGN DSK BPTEMPjJ 
DSK ASSIGNEDjJ 

.R BATCH ^ 
*INPUT PTR:^ 

*OUTPUT LPT-.jJ 

*SKIP OjJ 

$JOB TESTOl ,12 200 16,11 NANCY^ 
MOUNT TAPE D2621 WRITE ENABLED^J 

DTA6:^ 

*CONTINUE^ 
BREAKjJ 

RUN TIME - 23 SECS.jJ 
*SKIP 2 ^ 

$JOB PASS! BEAVER, 12 200 16,11 NANCY 
DUMPji 

RUN TIME - 12 SECS.^ 

$JOB PASS2 BEAVER, 12 200 16,11 NANCY 
RUN TIME - 32 SECS.^ 
END OF BATCH 

.KJOB ^ 



Assign the Batch scratch file, BPTEMP, 
to the disk. 

Load Batch. 

Assign the paper tape reader as the 
input device. 

Assign the line printer as the output 
device. 

Initialize Botch execution; begin with 
the first job found on the input device. 

Contents of the first $JOB card are 
typed out. 

Message to operator to mount a DEC- 
tape, serial number 2621 , on a DEC- 
tape drive (write enabled). 

Operator mounts the tape on an avail- 
able DECtape unit, either before or after 
typing the physical name and number 
of the drive . 

Batch responds with message "OK." 

Operator types "CONTINUE" to re- 
sume execution . 

Complete the current job, but halt be- 
fore continuing to the next job . 

Run time typed out . 

Skip the next two jobs and continue at 
the third job . 

Typeout of $JOB card. 

Perform a core dump on the current job 
and terminate the job; resume processing 
at the next job. 

Typeout of $JOB card. ■ 

All jobs on the Botch input device have 
been processed . 

Return to the Monitor. 

Kill the job, deassign the BPTEMP de- 
vice, release core . 
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Table BATCH-1 Batch Diagnostic Messages 



Message 


Meaning 


XXX XXX ? 

dev ? 


The previous operator typein, xxxxxx has no mean- 
ing to Batch. 

An illegal device was specified in an INPUT or 
OUTPUT command. 


END OF BATCH 


The end of file has been reached on an input stack 
(nondirectory devices). 

If the Batch input stack is on a directory-oriented 
device, the message can mean that either (1) end 
of the input stack has been reached, or (2) no such 
file exists on the device. 


FILE BEING MODIFIED 


A selected disk file Is currently being accessed by 
another user. 


MAX. TIME EXCEEDED 


The time limit specified on the $JOB card has been 
exceeded. The operator can respond with a typein 
of "TIME" to extend the time limit indefinitely. 


MOUNT TAPE label WRITE ■ 


"enabled" 

LOCKED 




Operator looks for available tape unit (if label be- 
gins with a "D," a DECtape unit is being requested; 
if label begins with an "M," a magnetic tape unit 
is being requested) and types in the physical name 
and number of the device in the form 

DTAn:^ or MTAn:,J 

If the device is available. Batch responds with "OK." 
The operator then mounts the requested tape (identi- 
fied by the serial number "label") on the drive, sets 
the WRITE switch in the proper position, and types 
"CONTINUE" to resume processing. 


NO PTY'S AVAILABLE 


No pseudo-Teletypes are available. The user must 
wait until one of the current Batch jobs is finished. 

NOTE: The user can increase the number of pseudo- 
Teletypes available by recreating his 
Monitor via Build. There are no hardware 
limitations (except core - each additional 
pseudo-Teletype requires about 20g words 
ot core and each possible time-shared job 
requires about 50g words). 


NO SUCH JOB 


The operator typed a SKIP command with an argument 
which resulted in a reference to a nonexistant job 
number on a directory device. 


NO SUCH UFD 


Reference has been made to a nonexistant UFD 
(User File Directory). 
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Table BATCH-1 (cont) Batch Diagnostic Messages 



Message 


Meaning 


dev NOT AVAILABLE 


The device either does not exist or has been assigned 
repeated . 


OK 
* 


Typed following a correct operator response. Type 
"CONTINUE" to resume processing. 


PLEASE ASSIGN dev TO BATCH PROCESSOR 

* 


Operator must: 

1 . Return to Monitor level (^C); 

2. Assign the requested device (ASSIGN dev); 

3. Type "CONTINUE"^ to Monitor; and 

4. Type "CONTINUE" to Batch. 


PLEASE ASSIGN DEVICE BPTEMP 
* 


The operator has failed to assign a device to the 
Batch scratch file, BPTEMP. He must: 

1 . Return to Monitor level (^C); 

2. Assign the device (ASSIGN dev BPTEMP); 

o, lype LUNIlNUt to Monitor; and 

A T II 1 TT K. 1 1 ICII J. n J. 1 

4. Type CONTINUE to Batch. 


PLEASE MOUNT A SCRATCH TAPE 


Operator responds by typing in the name of the 

I* l*lilt 1 1 •!/ 

drive on which the tape has been mounted (e.g., 
DTA3, DTAZetc). 


PROTECTION FAILURE 


The disk file referenced was protected. 


RUN TIME - n SECS. 


The total running time for each user job is typed at 
the end of the job. 


SPECIFY NEW OUTPUT DEVICE 
* 


This message appears following the operator's use of 
the EFOUT command. The operator must type 

OUTPUT dev:jj 

betore typing CONTlNUb. 


dev : TRANSMISSION ERROR 


An I/O data or device error has occurred. 


TRIED RENAME TO EXISTING NAME 


This is the result of attempting to rename an existing 
file to a name that already exists on the disk (applies 
to disk files only). 


USER NEEDS DEVICE dev 

* 


When device is available, operator types "CON- 
TINUE" to resume processing. 


NOTE: 1 . Typing "REENTER" (instead of "CONTINUE") to Monitor causes Batch to respond with an 
asterisk, following which the operator types "CONTINUE" to Batch. (If "CONTINUE" is 
typed to Monitor, Batch responds only with a carriage return.) 
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JOB STACKER (STACK) 



This section was not available at publication time, but will soon be available as an insert. 
If you do not receive this insert, please write to: 

DEC Program Library 

Digital Equipment Corporation 

146 Main Street 

Maynard, Massachusetts 01754 
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SYSTEM BUILDER (BUILD) 
(FOR TIME-SHARING MONITORS) 



FUNCTION To construct a time-shoring monitor 

specialized for the user's particular 
machine configuration. 

• Permits the distribution of Monitor as a set of 
modular subprograms, the selection of which 
is determined by the user's requirements 

• Employs an easy-to-use dialogue technique 
for requesting information from the operator 



ENVIRONMENT 



Monitor 


10/40, 10/50, or Minimal Monitor 


Minimum Core 


3K plus core needed for monitor being built. 


Additional Core 


Uses as much core as given in R(UN) command. 


Equipment 
Required 


One DECtape unit for the input Build tape^ containing the 
following files: 

SYS50 - for 1 0/50 systems 

SYS40D - for 10/40 systems with a disk 

SYS40N - for 10/40 systems without a disk 



NOTE: An up-to-date set of instructions for constructing your time-sharing system and "getting on the 
air" upon delivery of your PDP-10 is included in the software kit accompanying your machine. 
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COMMANDS 



. AS DTA3 DTAI d DTAi is the logical device name 

DTA3 ASSIGNED/j/ assigned to the Monitor library file. 

.R BUILD core(^ Core available can be specified as 

any number of 1 K modules . 



The user has the option of using an existing command list file as input to Build instead of 
conducting the dialogue described below (the first question asked is whether the user has such a file on 
a device). If the user has no such file (this would, of course, be the case when a given configuration 
is to be built for the first time), he may have one created as a by-product on some retrievable device 
as he conducts his Teletype dialogue; whether or not such a file is created is determined by the user's 
response to the second question asked. Thus, for all subsequent building operations where the same 
configuration is desired, the user can utilize the command list file created during the first building process. 

The file created is automatically given the extension LST, and any command list file read by 
Build is expected to have the same extension (thereby ensuring compatibility); the user may not type an 
extension. If the user types the filename only, the device is presumed to be DTAI, the Build input device. 



a. TYPE "DEVICE: NAME<CR>" OF FILE WHERE ANSWERS 
ARE PRESTORED^ 

TYPE <CR> ONLY FOR TELETYPE DIALOGUE^/ 

b. TYPE "DEVICE: NAME<CR>" TO CREATE A COMMAND 
FILE; <CR> FOR NONE^/ 
DSK: SYSABCt/ 

c. IS EITHER A 10, 20, OR 30 SYSTEM TO BE BUILT 
(TYPE Y OR N)?^ 

d. IS A 10/40 SYSTEM TO BE BUILT (Y OR N)?^ 
Y^ or N^ 

e. DO YOU HAVE A DISK?^ 
Y^ or N^ 

f. DO YOU HAVE AN RD10 SWAPPING DISK?^ 
Y^ or N^ 

g. DO YOU HAVE A PDP-10 PROCESSOR^ 
Y^ or N^ 

h. DO YOU WISH TO HAVE EXEC DDT LOADED (Y OR N)7gt 
Y^ or N^ 

i. DO YOU WISH TO HAVE LOCAL SYMBOLS LOADED 
(Y OR N)?^ 

or N^ 
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If a file IS specified, only question j 
will be asked out of those listed below. 



If Y, the single-user Build code is 

written over the current time -sharing 
Build code and begins executing. 

A 1 0/40 or 1 0/50 system is to be built. 

Type Y if 10/40; type N if 10/50. 



Type Y if you have a disk; type N if 
you do not . 



If response is N, a PDP~6 processor is 
assumed . 

Type Y if you wish DDT loaded for 
Monitor testing; type N if you do not . 

Needed only if EXEC DDT is loaded. 
Type Y if yes; type N if no. 

NOTE: EXEC DDT and local symbols 
need be loaded only for Monitor de- 
bugging. 



I- 



TYPE NAME OF THIS SYSTEM (10 CHARACTERS OR 
LESS)i^ 

VERSIONIO^ 



Type in the name you wish assigned to 
this monitor version. This name is 
printed on the Teletype whenever this 
version is loaded. 



k. TYPE NAME OF SYSTEM DEVICEf^ 
DSKt^ 



Type the name of the device to which 
the logical name SYS is to be assigned 



I. WHICH OF THE FOLLOWING LINE SCANNERS DO 
YOU HAVE?^^ 

DCS (DATA COMMUNICATION SYSTEM 630)^^ 

DLS (DATA LINE SCANNER DCIO)/^ 

CCI (COMPUTER-COMPUTER INTERFACE DA10 WITH 

PDP-8 AND 680 SYSTEM)^ 

TYPE DEVICE MNEMONIC<^ 

DLS^ (or either of the other two) 
m. DO YOU HAVE ANY OF THE FOLLOWING?,^ Type Y if you have the device or fea- 



PT READER?^ 
Y^ or N^ 
PT PUNCH?i^ 

or N^ 
PLOTTER?^ 
Yd or N(^ 
LINE PRINTER?^ 
Y^ or 

CARD READER?^ 
Yd or Nd 

IS YOURS A MODEL CR-10 PDP-10 CARD READER?^ 

Yd or Nd 
Dl SPLAY? 
Yd or Nd 

HOW MANY (DECIMAL) OF EACH OF THE FOLLOWING Type a decimal number signifying the 
DO YOU HAVE^ number of each type of device. 

DEC lAPES?d 



TYPE Y OR N ^ 



ture; type N if you do not. 



MAG TAPES?,^ 

DO YOU HAVE A TM-10 MAG TAPE CONTROL 
(Y OR N)?^ 

Yd or^d 



n = 0 through 8 (Type 0, not N, if none). 



n 



= 0 through 8 (Type 0, not N, if none). 
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n. 



JOBS TO RUN AT ONE TIME (BOTH ATTACHED 
AND DETACHED)?^ 



o. PSEUDO TELETYPES?^ 

p. TYPE "DEVICE-MNEMONIC: CHANNEL" FOR 
ANY NONSTANDARD DEVICES 
TYPE ALT-MODE WHEN THROUGH^ 

*MET:6 

*(altmode) 

q. type "symbol - value" for any changes 
(value in decimal) 
type alt-mode when through^ 

JIFSEC = nn^ 
NSPMEM = nnnn^ 

DTTRY = 

MTSIZ = nnn^ 



LPTSIZ= nn^ 
DETDDB= 



STDENS= nj 



Global = Pl-number 



Enter the device mnemonics and 
priority channels for any of the user's 
own device service routines . 



Enter symbol and value for any global 
symbol to be changed, in the form 

symbol = value 
Povv^er source frequency. Standard = 60 „ 

Memory cycle |js X 1000. 
Standard = 2000. 

Number of retries on DECtape errors. 
Standard ™ 4, 

Size of magnetic t;.:^ 
number of words in buffer). 

Standard =128. 

Size of printer buffer (in number of 
words) , Standard = 24. 

Maximum number of detached jobs. 
Standard ~ 0. 

NOTE: (Number of jobs run of one 

time)~(number of Teletypes) = n 

Magnetic rape density and parity 

STDENS- D + P 

D^ P 

1 (200 bpi) 0 (odd) 

2 (556 bpi) 4 (even) 

3 (800 bpi) 

Standard = 2 (200 bpi, odd) 

User can also change standard priority 

interrupt assignments. 
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Device 



Paper tape rdr 
Paper tape pnch 
Line printer 
Card reader 
Display 
Scanner 
C. Teletype 
Arith. Proc. 
Light pen 
Clock 

D/Ct! - DEC/mag 
D/Cti - Disk 
DECtape 
Magnetic tape 
Disk 



PTRCHN = 3^ 



TaltmodeV 

r. type"devlce:name"for any special routines 
to be loaded. 

type alt-mode when through^ 



DTA1:XYZSER^ 



Global 



PRTRCHN 

PTPCHN 

LPTCHN 

CDRCHN 

DISCHN 

SCHCHN 

CTYCHN 

APRCHN 

PENCHN 

CLKCHN 

DCTCHN 

DCBCHN 

DTCCHN 

MTCCHN 

DSKCHN 



Standard 
10/40N 10/40D, 
10/50 



4 
5 
4 
3 
6 
4 
4 
3 
5 
7 
2 

5 
4 



5 
6 
5 
4 
6 
5 
5 
4 
6 
7 
3 
1 
5 
5 
6 



(ALTMODE) ,j 

TYPE "DEVICE :NAME <CR>" FOR STORAGE MAP: 
<CR>FOR NONEf/ 

LPT NOT AVAILABLE 

TYPE "DEVICE:NAME<CR>" FOR STORAGE MAP: <CR> 
DSK: SYSABC^ 



If on 10/40N system, changes Pi 
assignment of paper tape reader from 
4 to 3. 



Enter device and routine name for any 
routine to be included in the Monitor 
but not linked with the rest of Monitor 
(i.e., not linked to either the priority 
interrupt chain or wi th the other data 
(blocks); also for any device specified 

in response to the query "TYPE 

FOR ANY NONSTANDARD DEVICES" 
whose binary code is not in the appro- 
priate Build file . All files must be in 
Macro-output, Loader-input (relocatable 
binary) format. 

Delay occurs after ALTMODE until 
loading of routines is completed. 



FOR NONE^ 

File SYSABC.MAP will be written on 
the disk from which it can be copied 
at some later point in time. 
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.SAVE DTA1 filename. ext^ 
JOB SAVEDf^ 



BUI LD overlays itself with the construe 
ed Monitor and exits. 

User must now save the constructed 
Monitor on a DECtape. 
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DIAGNOSTIC MESSAGES 



Table BUILD-1 Build Diagnostic Messages 



Message 


Meaning 


CANNOT ENTER FILE 


The file-structured device for the command list file or the storage 
map is unable to receive an entry into its directory. Try: 

a. DECtape - Directory full 

b. DSK: - User file directory is v/rite protected, or 

the file is being modified. 


ERROR IN LOADER COMMAND 


A system or hardware malfunction has occurred. 


ILL. FORMAT LIBRARY TAPE BAD 


Build input tape is in error. Try to rerun. If second attempt fails, 
recreate the Build input tape and run again. 


INPUT ERROR LIBRARY TAPE BAD 


A read error has occurred on the Build input tape. Try to rerun. 
If second attempt fails, recreate the Build input tape and run 
again . 


name.LST NOT FOUND ON DE- 
VICE dev (Preceding message is 
retyped) 


User specified a command list filename that did not exist on the 
particular device. 


symbol old-val new-val 
MUL.DEF GLOBAL 


A global symbol has been multiply defined. The old value is 
accepted, the new value is ignored, and processing continues. 


dev NOT AVAILABLE 


Device is not available. Request another device. 


NOT ENOUGH CORE 


Occurs only when Build is being run in a time-sharing environ- 
ment. Assign more core and rerun Build. If this method fails, 
try one or more of the following. 

a. Run Build under a monitor containing only DECtape 
and line printer service routines. 

b. Do not load either EXEC DDT or local symbols. 


PROGRAM MUST BE RESTARTED 
WITH "RUN" COMMAND 


User typed "START", but part of the START code has been over- 
written by Build. User must use GET or RUN command to bring 
new copy of Build into core. 


filename. REL NOT FOUND 
or 

SYS.... REL NOT FOUND 


a. One of the user's programs requested for inclusion in the 
Monitor cannot be found on the device specified. Correct 
and re-enter the request. 

b. User has wrong library input file for configuration desired; 
check answers to questions c, d, and e of dialogue. 


symbol NOT FOUND 
TYPE " DEVICE: NAME<CR>" 
FOR STORAGE MAP; <CR> 
FOR NONE 


A device data block or device interrupt service routine cannot be 
found. Try the following: 



BUILD -7 



Table BUILD-1 Build Diagnostic Messages (Cont) 



Message 


Meaning 


LPT: 

Prinf<i mnr> on lino nr'ir^¥Qr 1 

EXIT 


a. If the user is including his own routines in the Monitor, 
he should check that the tags on his device data blocks 
and interrupt service routines are spelled correctly and 
are globals. 

b. Check if a device service routine is missing from the 
input library file, 

c. Check storage map for symbols. 

d. Restart Build from the beginning. 


UNDEFINED GLOBALS 


This message may appear at the end of the requested storage mop 
printout on either the line printer or the Teletype. If all input 
to Build is supplied by Digital, this message should not occur. 


WHAT? 


User has made a keyin error. Correct and re-enter. 
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I 



SYSTEM BUILDER (BUILD) 
(FOR SINGLE-USER MONITORS) 



FUNCTION 



To construct a single-user Monitor specialized for 
the user's particular machine configuration. 

• Permits the same modular distribution of 
Monitor components and user specialization 
and utilizes the same easy-to-use dialogue 
technique as the time-sharing version. 



ENVIRONMENT 



Monitor 


10/20, 10/30, or Minimal Monitor 


Minimum Core 


8K 


Additional 
Core 


Not used 


Equipment 
Required 


One DECtape unit for the input Build tape, containing the 
following files: 

SYSPAR 
SYSDEV 



NOTE- An up-to-date set of instructions for constructing your single-user system and "getting on the 
air" upon delivery of your PDP-10 is included in the software kit accompanying your machine. 
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COMMANDS 



.INIT(^ 

.AS DTA3 DTAIji 

DTA3 ASSIGNED^ 
.RUN DTAI BUILD^ 

DO YOU HAVE FLOATING POINT AND BYTE 
HARDWARE?;^ 

Yf/ or Nf/ 

DO YOU HAVE ANY OF THE FOLLOWING? 

TYPE Y OR NjJ 

PT READER 

Y^ or Nf/ 

PT PUNCH;^ 

Yd or N^ 

Line printer 

Yd or Nd 

CARD READER?^ 
Yd or N^ 
DISK?.-/ 
Yd or N^ 

HOW MANY OF EACH OF THE FOLLOWING DO 
YOU HAVE si 

DECTAPES?£/ 
nd 

MAGTAPES?!^ 
nd 

TYPE "DEVICE-MNEMONlC:CHANNEL" FOR 
ANY NONSTANDARD DEVICES^^ 

TYPE ALT-MODE WHEN THROUGH^ 



DTAI is the logical device name 
assigned fo the Monitor library file. 



If answer is N(o), simulators for these 
functions v^ill be ioaded as part of the 
Monitor. 



*MET:3 CALTMODE) /^ 



Where n is in the range 0 through 8. 



Where n is in the range 0 through 8. 



Enter the device mnemonics and priority 
channels for any of the user's own device 
service routines. 
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TYPE "SYMBOL = VALUE" FOR ANY CORRECTIONS 
DESIRED^ 

TYPE ALT-MODE WHEN THROUGH^ 



*PTRCHN = 3 (ALTMODEj ^ 



The value of any global symbol can be 
changed by typing 

symbol = value 

Among the globals whose values can 
be changed (and their standard values 
in decimal) are: 



DTTRY = 3 



MTSIZ - 128 



LPTSIZ = 24 



STDENS- 2 



(Number of retries 
on DECtape errors) 

(Size of magnetic 
tape records, i.e., 
number of data words 
in the buffer) 

(Size of line printer 
records, i.e., number 
of data words in the 
buffer) 

(Magnetic tape density 
and parity - see page 
BUILD-4) 



Priority channel interrupt assignments 



Device 


Global Sr 




Paper tape reader 


PTRCHN 


4 


Paper tape punch 


PTPCHN 


5 


Line printer 


LPTCHN 


5 


Card reader 


CDRCHN 


4 


Teletype 


TTYCHN 


7 


Arithmetic Processor 


APRCHN 




DECtape 


DTACHN 


3 


Magnetic tope 


MTACHN 


2 


Disk 


DSKCHN 


1 
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TYPE "DEVICEiNAME" FOR ANY SPECIAL 
ROUTINES TO BE LOADED.^ 

TYPE ALT-MODE WHEN THROUGH^ 
*DTA2:X YZSER(aLTMODe) J 



WHAT IS THE SIZE (IN K) OF CORE?r/ 
nn^ 

DO YOU WANT A STORAGE MAP?^^ 
Y^ or N^ 



Enter device and routine name for any 
routine to be included in the Monitor 
but not linked with the rest of the 
Monitor (i.e., not linked to either the 
priority interrupt chain or with the 
other data blocks); also for any device 
specified in response to the query 

"TYPE FOR ANY NONSTANDARD 

DEVICE" whose binary code is not in 
the appropriate Build file. All files 
must be in Macro-output, Loader-input 
(relocatable binary) format. 



Type the size of core in decimal; the 
value must be a multiple of 8. 



If a storage map is requested, an INIT 
is performed by Build on the line 
printer. If a line printer is not avail- 
able, the storage map is printed on the 
user's Teletype. 

Build overlays the old system with the 
newly generated Monitor, initializes 
it, and exits to the new Monitor. The 
new Monitor responds with a dot. At 
this point the user can begin typing 
commands to the new Monitor, or first 
save the new Monitor on DECtape by 
typing 



AS DTAO SYSd 
REENTER^ 



This causes the new Monitor to be 
saved on the SYS device (DTAO, in 
this example). 
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DIAGNOSTIC MESSAGES 



The diagnostic messages for the single-user Monifor Build are the some as those for the time- 
sharing Monitor Build (see Table BUILD-1). 
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TIME-SHARING MONITORS 



FUNCTION To schedule multiple-user time sharing of the system, 

to allocate available facilities to user programs, to 
accept input from and direct output to all system I/O 
devices, and to relocate and protect user programs 
in core. 

• Provide an advanced, third-generation, multi- 
programming, and time-sharing environment 

• Allow for a wide range of system facilities, from 
a minimum configuration of 16K of core and two 
DECtcpes up through 262K of core and a variety 
of devices, such as magnetic tapes, disks, dis- 
plays, plotters, real-time digitizers, and analog 
converters 



MONITOR 10/40 A proven multiprogramming time-sharing system which includes an I/O 

controller, run-time selection of I/O devices, job-to-job transition, 
job save and restore features, and memory dump facilities. All of these 
features are incorporated with concurrent real-time processing, batch 
processing, and time sharing. 

MONITOR 10/50 A full-range, disk-swapping, multiprogramming time-sharing system 

incorporating all of the features of Monitor 10/40 with greatly ex- 
tended capacity. 

Both of these systems are custom tailored to the user's needs by use of the System Builder. 
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I CONSOLE MODES 



Monitor Mode 



User Mode 



DDT Submode 



Detached Mode 



The console is in communication with the Monitor. All characters 
typed in are presented to and interpreted by the Monitor Command 
Interpreter. 

The console acts as an ordinary I/O device under control of the user's 
program . 

A special user Teletype I/O mode which does not interfere with the 
normal user I/O mode. 

The console is not in communication with either the Monitor Command 
Interpreter, DDT, or a user's job. Entered when the Monitor is first 
initialized or when DETACH is typed. 



CONT, HELP, REENTER, 

^X^^^™" ASSIGN, ATTACH, CCONT, CORE, CSTART,D, 

X\ DAYTIME, DEASSIGN, E, FINISH, GET, KJOB, 

\ Ns:x ^ PJOB, REASSIGN, RESOURCES, SAVE, TALK, 

, ^ ^ v\ / \TiME ERRONEOUS COMMANDS 

tcX.\ / / 

DETACH 
V 1 




ATTACH 




ILL. COMMANDS 
"JOB CAPACITY 
EXCEEDED" 

"X" 



Figure MONITOR-1 Console Teletype Mode 
MONITOR-2 



COMMANDS 



Table MONITOR-1 Time-Sharing Monitor Commands 





Format 


( 

Action 


Charac- 
teristics 


Diagnostic Messages 


TO GAIN 
ACCESS 
TO THE 
SYSTEM 


HELP 


The HELP command calls in a rou- 
tine which carries on a dialogue 
with the user at the console to ex- 
plain the use of the Monitor. 


u 




IHP' 


LOGIN 

(10/50 Monitor) 


LOGIN initializes a Monitor rou- 
tine to accept the user's LOGIN 
data. 

.LOGIN^ 

JOB n^ Job number assigned to 
user . 

xxx.xkkJ Monitor version being 
used . 

proj,prog^ User types in his 

project-programmer 
number (each number 
can be up to nine octal 
digits) . 

B^Vfii^ Monitor types out pass- 
vv-ord mask; user types in 
password over mask. 

If user entries are cor- 
rect, Monitor responds 
with^C and a period, 
indicating readiness to 
accepf a command. 


u 


LOGIN PLEASE 
? 

Command typed requires that the 
user be logged in . 

? SORRY — WRONG NUMBER 

An illegal project-programmer 
number was entered. 

7INCORRECT CODE — TRY 
AGAIN 

An illegal password was entered. 


TO 

ALLO- 
CATE 
FACILI- 
TIES 


ASSIGN 
phys-dev 
log-dev 


To assign an I/O device to the 
user's job for the duration of the job 
or until a DEASSIGN command is 
given . 

phys-dev Any device fisted in 
Tabie MONiTOR-2. 
This argument is re- 
quired . 

log-dev A logicoi name assigned 
by the user (e.g., in 
writing a program, the 
user may use orbitrariiy 
selected device names 
which he assigns to the 
most convenient physical 
devices at run time) . 
This argument is optional 

When a device is assigned to a 
job, it is removed from the 
Monitor's pool of available de- 
vices. 


m 

L, J 


dev: ASSIGNED 

The device has been successfully 
assigned to the job. 

NO SUCH DEVICE 

Device name does not exist. 

ALREADY ASSIGNED TO JOBn 

The device has already been as- 
signed to another user's job, 

LOGICAL NAME ALREADY IN 
USE DEVICE dev ASSIGNED 

The user has previously assigned 
this logical name to another device , 



if UlA or MTA is used^ Monitor performs o seorch for on avaUabie drive and then types our Di An (or MiAnj ASSIG^ 



NOTE: One command string only is typed per line, and each command string must be typed on a 
single line. 
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Table MONITOR- 1 TIme-Sharmg Monitor Commands (Cont) 





Format 


Action 


Charac- 
teristics 


Diagnostic Messages 


TO 

ALLO- 
CATE 
FACILI- 


ASSIGN SYS:dev 


To change the systems device to 
device "dev." The user must be 
logged in under either! 1 , ll or 
11,2] . 


m 
L 




TIES 
(cont . ) 


DEASSIGN dev 


Returns one or more devices, cur- 
rently assigned to the user's job 
to the Monitor's pool of available 
devices . 

If this argument is 
not specified, all 
devices assigne^d to 

f Kit's i;t£i>r'x SJ-^H ^s>-j-„l 

deossigned . 

If t^'S argumer,t i$ 
SDeC'ilpd, \f can be 
estrcr ^hr Icg'crl 

nome . 


m 
L 


NO SUCH DEVICE 

Device name does not exist. 

DEVICE WASN'T ASSIGNED 

The device isn't currently as- 
signed to thi< job. 




REASSIGN dev job 


Allows one job to pass a device 
to a second job without going 
through the Monitor device pool. 

"^^v T|-ie physfcoi nome of 
the device fo be re- 
assigned,. Connof- be o 
user console . 

job The number of the job 
to which fhe device 
IS to be reassigned . 


m 

L,J,I 


DEVICE dev WASN'T ASSIGNED 

s.-^e device isn't" cu'rerJiy o'. 

JOB NEVER WAS INITIATED 

The job number specified has 
not been initialized. 

NO SUCH DEVICE 

The device does not exist .. 
DEVICE CAN'T BE REASSIGNED 

A user's console feiet/pe ccr- 




FINISH dev 


Terminates any input or output 
currently in progress on the device. 

The logicoi or physi"- 
cq! name of the device 
on which I/O h to be 
term i noted . 

If no nome is speci- 
fied^ I/O is terminated 
all devices ''-^v -•■■-■-■'^ 


m 
L 


NO SUCH DEVICE 

t if her the device does nol' exist 
or it was not assigned to this job . 




TALK dev 


To allow the user to type directly 
on another user's console. 

dev /y\y5^ be one of the 
following 

^ ' ^ Console 

Teletype 

^TYn - VVhere n con 

be in the 

ronge of 0 
through 7" 


m 


BUSY 

The console addressed is either (1) 
not in the detached mode or the 
Monitor mode^ or (2) is not posi- 
tioned at the left margin. 
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Table MONITOR- 1 Time-Sharing Monitor Commands (Cont) 





Format 


Action 


Charac- 
teristics 


Diagnostic Messages 


TO 

ALLO- 
CATE 
FACILI- 
TIES 
(cont.) 


TALK (cont.) 


OPR - Operator's 
console (the 
Teletype de- 
signated as 
such when the 
Monitor was 
initialized) . 








CORE n 


To modify the amount of core as- 
signed to the user's job. 

n - Total number of 1 K 
blocks of core to be 
assigned to the job 
from this point on. 

If n is omitted, Mon- 
itor types out a value 
representing the num~ 
ber of 1 K blocks of 
unallocated core in 


m 

J,A,I 






RESOURCES 


To print out all the available de- 
vices (except TTY's) and the 
number of free blocks on the disk. 


m 






DETACH dev 


To assign the device "dev" to 
JOB 0, thus making it unavailable. 
The user must be logged in under 

['-']• 


m 
L 






ATTACH dev 


To return a detached device to the 
Monitor pool of available devices. 
The user must be logged in under 


m 
L 




TOCALL, 
LOAD, AND 
CONTROL 
PROGRAMS 


RUN dev 
filename. ext 
[proj,prog] 
core 


To load a core image from a re- 
trievable storage device and start 
it at the location specified within 
the file (JOBSA). 


u 
L 


dev: NOT AVAILABLE 

The device has been assigned to 

NO SUCH DEVICE 

The device does not exist . 

nK OF CORE NEEDED 

There is insufficient free core to 
load the file . 






dev The logical or physical 
name of the device 
containing the core 
image. Omitted if if is 
the systems (SYS:) de- 
ice. 








filename. ext The name of the file 
containing the core 
image; if . ext is 
omitted, it is assumed 
to be .DMP. 




NOT A DUMP FILE 

The file is not a core image file 






^pro j , prog] Project-programmer 

number; required only 
if core image file is 
located in a disk area 
other than the user's. 




TRANSMISSION ERROR 

A parity or device error occurred 
during loading. 
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Table MONITOR-! Time-Sharing Monitor Commands (Conf) 





Format 


Action 


Charac- 
teristics 


Diagnostic Messages 


TO CALL, 
LOAD, AND 

V* WIN 1 IV WL 

PROGRAMS 
(cont.) 


RUN (cont.) 


core Amount of core to be 
assigned if different 
from minimum core 
needed to load the 
program or from the 
core argument of the 
SAVE command which 
saved the file. Re- 
quired only if dev: is 
MTAn: 








GET dev 
f i lename . ext 

[ pro i, prog] 
core 


Some as RUN command except that 
Monitor types out 

JOB SETUP 
and does not start execution; also, 
if the core argument is not in- 
cluded it is assigned a value equal 
to the user's current core allocation 
(the SAVE core argument, if it had 
been used, is ignored). 


m 

l-,J,A 


Same as RUN. 




START adr 


Begins execution of a program pre- 
viously loaded with the GET com- 
mand . 

adr The address af which 
execution is to begin 
if other than the lo- 
cation specified with- 
in fslo / inR^^A'i 
Mi Trie 1 1 1 e \ j wd^m j . 


u 

L,J,C, 
A,I 


NO CORE ASSIGNED 

No core v-/as afiocaled io the 
user when the GET command was 
given end no core argument was 
specified in the GET . 




HALT (K) 


Places the console in Monitor mode 
and transmits a HALT command to 
the Monitor Command Interpreter. 
Stops the job and stores the program 
counter in the job data area 
(JOBPC). 


m 






CONT 


Starts the program at the saved 
program counter address stored in 
JOBPC by a HALT command (^C) 
or a HALT instruction. 


u 

L,J,C,I 


CAN'T CONTINUE 

; re |ob was r.QiieG dje t<; 

be con!:. 




DDT 


Copies the saved program counter 
value from JOBPC into JOBOPC 
and starts the program at an al- 
ternate entry point specified in 
JOBDDT (beginning address of DDT 
as set by Linking Loader). To re- 
turn to normal execution, type^C 
and START (or type prog-start- 
adr$G). 


u 

L,J,C I 






REENTER 


Similar to the DDT command. 
Copies saved program counter 
value from JOBPC into JOBOPC 
and starts program at an alternate 
entry point specified in JOBREN 
(must be set by the user or his pro- 
gram). To return to the interrupt- 
ed computation, type REENTER 

, 


u 

L, J,C,I 
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Table MONITOR-! Time-Sharing Monitor Commands (Cont) 





Format 


Action 


Charac- 
teristics 


Diagnostic Messages 


TO CALL, 
LOAD, AND 
CONTROL 
PROGRAMS 
(cont.) 


E adr 


To examine a core location in the 
user's area. 

adr if this argument is 
specified, the con- 
tents of the location 
ore typed out in half- 
word octal mode. Adr 
is required the first 
time the E command Is 
used . 

If odr is not specified, 
the contents of the lo- 
cation following the 
previously specified 
adr are typed out 


m 

L,J,C,I 


OUT OF BOUNDS 

is not in the 


D 1 h rh adr 


Deposit information in the user's 
core area. 

Ih The octal value to 

be deposited in the left 
half of the location. 

rh The octal value to be 
dep>osited in the right 
half of the location . 

adr The address of the lo- 
cation into whic 
information is to 
deposited. 

If odr is omitted, the 

data is deposited in 
the location following 
f-he last location ex- 
nined or deposited . 


m 

L,J,C,I 


OUT OF BOUNDS 

The specified adr is not in the 
user's core area . 


SAVE dev 
fllename.ext 
core 


To write out a core image of the 
user's core area on the specified 
device. If DDT was loaded with 
the program, the entire core area 
is written; if not, the area starting 
from zero up through the program 
break (as specified by JOBFF) is 
written. After output is com- 
pleted, the message 

JOB SAVED 

is typed. 

dev The device on which 
the core image file 
is to be written . 

filename. ext The name to be assignee 
to the core image file. If 
. ext is omitted it is ossumec 
to be .DMP. 


m 

LJ,C, 
A, I 

• 


n 1 K BLOCKS OF CORE NEEDED 

The user's current core aiiocation 
is less than ^he confenfs of JOBFF. 

DEVICE NOT AVAILABLE 

Device dev is assigned to another 

use*' ■ 

TRANSMISSION ERROR 

An err;-.^ 

DIRECTORY FULL 

Th. -V is 
full; no more files con be added. 
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Table MONITOR-] Time-Sharing Monitor Commands (Cont) 





Format 


Action 


Charac- 
tpri«:tir^ 


Diagnostic Messages 


TO CALL, 
LOAD, AND 
CONTROL 
PROGRAMS 
(cont , ) 


SAVE (cont.) 


core Amount oi core in 

which the program is to 
be run. This value is 
stored In the job's core 
orea (JOBCOR) and is 
used by the RUN and 
GET commands. Speci- 
fied OS number of 1 K 
blocks. 

If core is omitted^ only 
the number of blocks 
required by the core 
image orea (as ex- 
plained above) is os- 






TO 

CONTROL 
BACK- 
GROUND 
JOBS 


PJOB 


Monitor responds by typing the job 
number to which the user's console 
is attached. If the console is not 
attached to a job. Monitor assigns 
a job number and types the job 
number and a line identifying the 
Monitor version. 


m 

L, J 




C START 1 
CCONT J 


Identical to the START and CONT 
commands, respectively, except 
that the console is left in the 
Monitor mode. 

To Use: 

1 . Begin the program with the 
console in user mode. 

2. Type control information to 
the program, then type^C 
to halt job with console in 
Monitor mode. 

3. Type CCONT to allow job to 
continue running and leave 
console in Monitor mode. 

4. Further Monitor commands can 
now be entered from the 
console. 


m 

L,J,C,I 


Some as START and CONT. 


DETACH 


Disconnects the console from the 
user's job without affecting the 
status of the job. The user console 
is now free to control another job, 
either by initiating a new job or 
attaching to a currently running 
background job. 


d 
L 




ATTACH job 
Qproj,prog] 


To connect a console to a back- 
ground job. 

job The job number of the 
job to which the con- 
sole is to be attached,:. 


m 


If an error message occurs, the 
console remains attached to its 
current job. 
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Table MONITOR-1 Time- Sharing Monitor Commands (Cont) 





Format 


Action 


Charac- 
teristics 


Diagnostic Messages 


TO 

CONTROL 
BACK- 
GROUND 
JOBS (cont.) 


ATTACH (cont.) 


[pro j, prog] 

'rogrammer number of 
the originator of the 
desired job. 

Automatically detaches the console 
from any job to which it is currently 
attached. 

If job is running, typing CONT 
places the console in the user mode 
without affecting the operation of 
the job. 




TTYn ALREADY ATTACHED 

Job number typed Is erroneous 
and is attached to another con- 
sole, or another user is attached 
fhe job. 

JOB NEVER WAS INITIATED 

. he job number is not assigned to 
any currently running job. 

NOT JOB ORIGINATOR 

[he project-programmer number 
entered is not that of the origin- 
or of the desired jo' 


JOB 

TERMIN- 
ATION 


KJOB 


Stops all allocated I/O devices and 
returns them to the Monitor pool. 
Returns all allocated core to the 
Monitor pool . 

Returns the job number to the 
pool . 

Leaves the console in the Monitor 
mode. 

Performs an automatic TIME com- 
mand. 


m 
A 




SYSTEM 
TIMING 


UAY 1 1/V\L 


Types the date followed by the time 
of day. Time is typed in the format. 

hhmm:ss .ss 

where 

hh = hours 
mm = minutes 

ss.ss = seconds to the nearest 
hundredth. 


m 




TIME job 


Types out the total running time used 
by the job since it was initialized. 
Interrupt level and job scheduling 
times are charged to the user who 
was running when the interrupt or re- 
scheduling occurred. 

job i'ne jOD n,, - - 
job whose 
desired . 


m 
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Table MONITOR-1 Monitor Commands (Cont) 





Format 


Action 


Charac- 
teristics 


Diagnostic Messages 


SYSTEM 
TIMING 
(cont.) 


TIME (cont.) 


;ob is omitted, the 
job to which the con-- 
sole is attached is as- 
sumed. In this case , 
Monitor types out the 
incremental running 
time (running time 
since last TIME com- 
mand) as well as the 
total running time since 
the job was initialized. 

If job 0, an approx-- 
imation of the time 
spent core shuffling is 
printed^ followed by 
the running time of the 
null job, and the total 
system up time . 






Characteristics: 

d = places console in detached mode L = LOGIN required (10/50 Monitor) J = requires a job number 
m= places console in Monitor mode A = no active device 
u = pieces console in user mode C = core required 

I = must be in core: 
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Table MONITOR-2 Time-Sharing Monitor Device Summary 



Physical 
Name 


Device 


Program 
Operators 


Data Modes 


CTY 


Console Teletype 


INPUT, OUTPUT 


A, AL 


TTYn 

(n = 0 
thru 7) 


Teletype 


INPUT, OUTPUT 


A, AL 


PTR 


Paper tape reader 


INPUT 


A, AL, IB, B, I 


FTP 


Paper tape punch 


OUTPUT 


A, AL, IB, B, I 


LPT 


Line printer 


OUTPUT 


A, AL 


CDR 


Card reader 


INPUT 


A, AL, B, I 


DTAn 

(n = 0 
thru 7) 


DECtape 


INPUT, OUTPUT 
LOOKUP, ENTER, 
USETO, USETI, 
UGETF, 
CALL [SIXBIT/ 
UTPCLR/] 


A, AL, IB, B, I, DR, D 


MTAn 

(n = 0 
thru 7) 


Magnetic tape 


TK.IDI IT ITDI IT 

INrUI, UUIKUI 
MTAPE 


A, AL, ID, D, 1, Ul\f U 


DSK 


Disk 


INPUT, OUTPUT 
LOOKUP, ENTER 


A, AL, IB, B, I, DR, D 


Data Modes: A = A.SCII DR = Dump records (some 
AL = D = Dump 
IB = ^.-v. / 
B = Blnarv 
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I DIAGNOSTIC MESSAGES 



In addition to the diagnostic messages given for each command. Monitor also types out the following 
error diagnostics. Except for the DEVICE dev OK? and HALT AT USER adr messages, all messages are 
for errors so serious that Monitor stops the job and does not allow the user to continue execution of the 
job with a CONT command. 



Table MONITOR-3 Time-Sharing Monitor Diagnostic Messages 



Message 


Meaning 


ADDRESS CHECK FOR DEVICE dev AT USER 
adr 


Monitor has checked a user address and has found 
it to be too large (> C(JOBREL)) or too small 
(< JOBPFI). Some user addresses can be the 
user's accumulators while others cannot. 

Une ot the tol lowing addresses may be wrong: 
buffer 

buffer header 

dump mode command list 

data specified by dump mode command list 

I n CI IrT 1 ^ 1 ^ n ^" C'CW^ r\\l r\ \\ r\r\\ ^ t^i* c^fl-irxi^i 1 1 

I I idul 1 1^ Id i 1 uv^i cr uvuiiuuic Tur SGrring up 
Monitor -generated buffers. 


BAD DIRECTORY FOR DEVICE DTAn; 
UUO AT USER adr 


The DECtape directory is not in proper format or 

nnri n r^nr'ii'x/ oi*r<^r xa/I^qi^ v^r\f\ KA/^t^\f 

nuu u puiiiy cirur wnen reaa . /viany rimes rnis 
error occurs when an attempt is made to use a 
virgin tape. 


DEVICE dev OK? 


Lyevice aev is Temporarily in an inoperable state, 
such as LPT offline. The user should correct the 
obvious condition and then type a CONT com- 
mand . 


ERROR IN JOB n 


A fatal error has occurred in the user's job (or in 
Monitor while servicing the job). This typeout 
is normally followed by a 1-line description of 
the error. 


HALT AT USER adr 


The user program has executed a halt instruction 
at loc. adr. Typing CONT will resume execu- 
tion at the effective address of the halt. 


HUNG DEVICE dev; UUO AT USER adr 


A device has not generated an interrupt for a 
timed period and, therefore, is in need of 
attention . 


ILLEGAL DATA MODE FOR DEVICE 
dev AT USER adr 


The data mode specified for a device in the 
user's program is illegal. 
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Table MONITOR-3 Time-Sharing Monitor Diagnostic Messages (Cont) 



Message 


Meaning 


ILLEGAL UUO AT USER adr 


An illegal UUO has been executed at user 
location adr. 


ILL INST. AT USER adr 


An illegal operation code has been encountered 
in the user's program. 


ILL MEM REF AT USER adr 


An illegal memory reference has been made by 
the user program at adr or adr+1 . 


INCORRECT RETRIEVAL 
INFORMATION: UUO AT USER adr 


The retrieval pointers for a file are not in the 
correct format; the file is unreadable. If this 
typeout occurs, the user should report it on a 
Software Trouble Report. 


INPUT DEVICE dev CANNOT DO 
OUTPUT; UUO AT USER adr 


An illegal OUTPUT UUO has been executed 
at user location adr. 


I/O TO UNASSIGNED CHANNEL AT 
USER adr 


No OPEN or INIT was performed on the channel. 


JOB CAPACITY EXCEEDED 
or 

X 


The job capacity of the system (i.e., the ca- 
pacity selected when this Monitor was generated 
by Build) has been exceeded. The command is 
ignored. The user must wait until another user 
has relinquished his job number. 


LOGIN PLEASE 
? 


A Monitor command requiring that the user be 
logged in has been typed, but the user is not 
logged in. Perform LOGIN and repeat the 
command . 


LOOKUP AND ENTER HAVE 
DIFFERENT NAMES: UUO 
AT USER adr 


An attempt has been made to read and write a 
file on the disk. However, the LOOKUP and 
ENTER UUO's have specified different names on 
the same user channel . This message does not 
indicate a DECtape error. 


MASS STORAGE DEVICE FULL; 
UUO AT USER adr 


The storage disk is full . Users must delete un- 
needed files before the system can proceed. 


NON-RECOVERABLE DISC READ 
ERROR; UUO AT USER adr 

NON-RECOVERABLE DISC WRITE 
ERROR; UUO AT USER adr 


Monitor has encountered an error while reading 
or writing a critical block in the disk file struc- 
ture (e.g., the MFD or the SAT table). If this 
condition persists, the disk must be reloaded us- 
ing Failsafe after the standard location for the 
MFD and SAT table has been changed using the 
Monitor once-only dialogue. 
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Table MONITOR-3 Time-Sharing Monitor Diagnostic Messages (Cont) 



Message 


Meaning 


NOT ENOUGH FREE CORE IN 
MONITOR: UUO AT USER adr 


The Monitor has run out of free core for assign- 
ing disk data blocks and Monitor buffers. If 
this typeout occurs, the user should report it on 
a Software Trouble Report. 


NOT FOUND 


The program file requested cannot be found on 
the systems device (or on the specified device). 


OUTPUT DEVICE dev CANNOT DO 
INPUT; UUO AT USER adr 


An illegal INPUT UUO has been executed at 
user location adr. 


PC EXCEEDS MEMORY BOUND AT 
USER adr 


An illegal transfer has been made by the user 
program to user location adr. 


SWAP READ ERROR 


A consistent checksum error has been encountered 
when checksumming locations JOBDAC through 
JOBDAC+74 of the Job Data area during swap- 
ping. 


SWAPPING DEVICE FULL 


The swapping device is full of user core images. 
One or more users must eliminate their core 
images by typing KJOB before the user can pro- 
ceed. This message is printed every 30 seconds 
until space is made available. 


TOO FEW ARGUMENTS 


A required argument was omitted in a Monitor 
command string. 
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SINGLE-USER MONITORS 



FUNCTION . , . 

I To perform job-to- job transitions, assign I/O devices 

at run time, and perform all I/O device service func- 
tions for standard devices. 

• Provide Monitor control of jobs and ease of 
programming for I/O devices in a single-user 
environment 

• Provide upward compatibility with the time- 
sharing Monitors 10/40, 10/50 

• Allow for a wide range of system facilities, from 
a minimum configuration of 8K of core (16K for 
the 10/30 Monitor) and paper tape up through 
262K of core and the same range of devices 
given for the time-sharing Monitors 



MONITOR 10/10 A single-user Monitor for an 8K paper tape system. Includes an I/O 

Controller, run-time selection of I/O devices, job-to-job transition, 
job save and restore features, and memory dumps. 

MONITOR 10/20 A single-user Monitor for an 8K DECtape system. Includes the same 

versatile features as the 10/10. 

MONITOR 10/30 A single-user Monitor for 16K and larger systems. Includes the same 

versatile features as the 10/10. 

All of these systems are custom-tailored to the user's needs by use of the System Builder. 
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CONSOLE MODES 



Monitor Mode The console is in communication with the Monitor. All characters 

typed in are presented to and interpreted by the Monitor Command 
Interpreter. 

User Mode The console acts as an ordinary I/O device under control of the user's 

program . 

DDT Submode A special user mode which does not interfere with the normal user 

mode . 




Figure MONITOR-2 Console Teletype Modes (Single-User) 
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COMMANDS 



Table MONITOR-4 Single-User Monitor Commands 





Format 


Action 


Charac- 
teristics 


Possible Causes of "?" Diagnostic 


TO 

INITIALIZE 
THE SYSTEM 


INIT 


Initializes the I/O package for the 
user as follows. 

1 . Releases the logical names (ex- 
cept SYS) assigned to every 
device . 

2. Release the directory space of 
every device having a logical 
name . 

3. Sets the contents of JOBREL 
equal to the address of the first 
location below the Monitor. 


m 




TO 

ALLOCATE 
FACILITIES 


ASSIGN phys-dev 
log-dev 


To assign an I/O device to the user's 
job for the duration of the job or 
until a DEASSIGN command is given 
for the device . 

phys-dev Any device listed in 
Table MONITOR-5. 
This argument is re- 
quired . 

log-dev A logical name assigned 
by the user (e.g., in 
writing hi$ program , the 

user may use arbitrari!/ 
selected device names 
which he can then as- 
sign to the most con- 
venient physical devices 
at run ^irre). This argu- 
- - ' n-t'ona! . 


m 


a) phys-dev could not be found. 

b) log-dev is already assigned . 


DEASSIGN dev 


Releases the logical name from the 
device and core space allocated to 
its directory (if any); updates JOBREL 

dev fhis argument can be 
either the logical or 

Dhysical device name 


m 


dev could not be found. 
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Table MONITOR-4 Single-User Monitor Commands (Cont) 





Format 


Action 


Charac- 
teristics 


Possible Causes of "?" Diagnostic 


TO CALL, 
LOAD, AND 
CONTROL 
PROGRAMS 


RUN dev prognome 


To load a core image from a retriev- 
able storage device and start it at the 
location specified within the file 
(JOBS A). 


u 


a) dev could not be found. 

b) progname could not be found. 

c) (JOBSA)|^j^ =0. 






dev The logical or physical 
name of the device con- 
taining the core image. 
If this arg{jmer\f is omit- 
ted, the Systems (SYS) 
device is assumed, 

progname The name of the file 
contolning the core 






GET dev progname 


Same as the RUN command, except 
that the job is not started. 


m 


a) dev could not be found. 

b) progname could not be found. 




START 


Gives control to a job at its starting 
address, as specified by the right 
half of JOBSA. 


u 


(JOBSA)^^ = 0. 




tc (HALT) 


Places the console Teletype in Mon- 
itor mode and transmits a HALT com- 
mand to the Monitor Command In- 
terpreter. Stops the job and stores 
the program counter in the job data 
area JOBOPC. 


m 






CONT 


Starts the program at the address 
stored in the saved program counter 
(JOBOPC) following a HALT com- 
mand i^C). 


u 


CfJOBOPD = 0 




DDT 


Starts execution of the program at 
the location specified in JOBDDT. 
This location is set at the starting 
address of DDT by Linking Loader. 


u 


(JOBDDT)|^j^ = 0 




REENTER 


Restarts an interrupted job at a point 
specified by the user in JOBREN; 
the program counter value is in 
JOBOPC. To return to the inter- 
rupt point, execute a JRST 2,@ 
JOBOPC. 


u 


(JOBREN)|^^ = 0 
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Table MONITOR-4 Single-User Monitor Commands (Cont) 





Format 


Action 


Charac- 
teristics 


Possible Causes of "?" Diagnostic 


TO CALL, 
LOAD, AND 
CONTROL 
PROGRAMS 
(cont.) 


SAVE dev progname 


Copies the contents of the user's core 
area (and part of the job data area) 
onto device "dev" and assigns it the 
filename "progname .SAV" . If DDT 
is loaded, the area of core from 
JOBDDT through the address con- 
tained in JOBREL is saved: other- 
wise, the core area from JOBDDT 
through the job break (address in 
JOBFF) is saved. 


m 


a) dev could not be found. 

b) progname cannot be ENTERed 
on the device 

c) Transmission error 


JOB 

TERMINA- 
TION 


KJOB 


Kills the job and releases every 
active device . 


m 




SYSTEM 
TIMING 


DATE mm-dd-yy 


Converts the date typed by the user 
to the standard internal format and 
stores it in the system date location . 


m 




Characteristics: m Command places user's console in Monitor mode. 

u Command places user's console in user mode. 
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DIAGNOSTIC MESSAGES 



Table MONITOR-5 Single-User Monitor Diagnostic Messages 



Message 


Meaning 


? 


Generally, this typeout means that a command 
was typed incorrectly (e.g., a space was omitted, 
a parameter was omitted or misspelled). Other 
reasons for this message are given under the head- 
ing "Possible Causes of the ? Diagnostic," Table 
MONITOR-4. 
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[assembly instructions for cusp sources 

The only source programs requiring special assembly or loading procedures are: 

F4, F40, F4S, F40S 
PIP and PIPl 

DDT and Exec Mode DDT 

GLOB 

AID 

DESK 

Detailed instructions for assembling and loading the above programs follow. All other CUSP 
(Commonly Used System Programs) sources are assembled using Macro, and then simply loaded and saved. 



F40 



The PDP-10/PDP-6 FORTRAN IV Compiler consists of a single set of source files which, 
through conditional assemblies, produce the following: 

1. F40/F4: Full-scale FORTRAN IV, which will compile programs on any PDP-lO/PDP-6 
having a minimum of 9K of user core available. The code it produces will run on the 
computer which compiled it, 

2. F40S/F4S: An abbreviated version of F40/F4 which will operate in 5,5K of user core 
on the PDP-lO/PDP-6. 

The Compiler source consists of five files: EXEC, FXO, FXl, FX2, FX3. 

F40 is the PDP-10 Compiler. 

F4 is the PDP-6 Compiler. 

F40.SAV is the name given to the F40 Compiler on the PDP-10 CUSP. 
F4. DMP is the name given to the F4 Compiler on the PDP-6 CUSP. 
To create F40.SAV or F4.DMP: 

1. Assemble FXl, FX2, FX3 as one file (F40.RELor F4.REL). 

2. Assemble EXEC as EXEC. RE L. 

3. Load EXEC, then F40.RELor F4.REL in IIK, 

4. Save F40 or F4 in 9K. 

To create F40.SAV or F4S.DMP: 

1 , Assemble FXO, FXl , FX2, FX3 as one file (F40S.REL or F4S.REL) 

2, Load F40S.REL or F4S,REL in 8K, 

3, Save F40S or F4S (in 6K for 10/40, 10/50 systems). 
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The executive (FXO or EXEC) handles all input/output operations. Before assembling the files 
FXl , FX2, and FX3, the user may define some parameters to conserve space or give the Compiler addi- 
tional features (see below). All the parameters except DEBUG have been defined in the small executive 
(FXO), enabling the abbreviated version to reside in approximately 5.5K of core instead of 9K. 



HALFWD Assemble interpretive instructions two per word. 

$CCONS The Compiler feature of collapsing constants will be removed. 

$FAD The Compiler will not use floating point instructions in its cal- 

culations. If $FAD is defined, $CCONS will be automatically 
defined. 

$IMPL The IMPLICIT statement will not be accepted. 

$DATA The DATA statement will not be accepted. 

$CODE The binary listing option will be removed. 

$NAME The NAME LIST statement will not be accepted. 

$CREF The cross-reference symbol table feature will be removed. 

DEBUG The debug package will be assembled. 



ASSEMBLE/LOAD PROCEDURE 



F40: 

.R MACRO ^ 

*DSK:EXEC, <- DTAn:EXEC^ 

*DSK:F40,<- DTAn:FXl.MAC, FX2.MAC, FX3.MAC^ 
*^C ^ 

.R LOADER^ 

*DSK:EXEC, F40 (ALTMODE) ^ 

LOADER J 

EXIT^ 

^C^ 

.SAVE DSK F40 9 J 
F40S: 

.R MACRO^ 

*DSK:F40S,<>- DTAn:FXO, FXl, FX2, FXS) 
.R LOADER^ 

*DSK:F40S (ALTMODE) fj 
LOADER^ 

.SAVE DSK F40S 6^ 
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PIP, PIPl, QPIP 



PIP: Assemble separately the files COMSN and PIP. 

There are two assembly parameters in PIP: WCH and BLOCO. 

WCH = 0 New (i.e., PDP-10) format DECtapes are assumed. 
WCH = 1 Old (i.e. , PDP-6) format DECtapes are assumed. 

BLOCO not defined Block 0, 1 , and 2 copying is allowed. 
BLOCO defined No block 0, 1 , and 2 copying is allowed. 

Typical procedures for PIP assembly, load, and save are: 

.R MACRO ^ 

*DTAn:PIP, ^ TTY:, DTAm:PIP^ 
WCH= 0^ 

END OF PASS ONE ^ 
WCH = 0 ^ 

*DTAn:COMSN, DTAm:COMSNA 

Then load the two files as follows. 

• R LOADER^ 

• DT An :COMS N , PI Pi CMTMODE) ij 
LOADER li 

EXIT^ 

. SAVE DTAn:PIP 3^ 

PIPl : Assemble separately the files COMSCN.MAC and PIPl .MAC. Then load them as follows, 
noting the order. 

• R LOADER^ 

*DTAn:COMSCN,PIP1 (ALTMODE) J 

LOADER^ 

EXIT^ 

Now save PIPl on your CUSP 

• SAVE DTAn:PIPl 1^ 

QPIP is an ASCII file containing the switch information which PIP prints upon encountering the 
/Q switch in a command string. The QPIP file should simply be transferred to your CUSP using PIP. 
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DDT 



User DDT is kepf as a REL file and as a SAVED file on the CUSP tape. 

Assemble the file DDT, MAC with Macro. DDT assembles with one argument 'A' error. This error 
may be ignored and does not affect the user at all. DDT. REL is transferred onto a CUSP via PIP, 
while the GET and SAVE Monitor commands are used for DDT.SAV. 



How to Load and Save DDT.SAV 
.R LOADER 4 ci 

*DTA1:DDT,/140G (ALTMODE) d 

LOADER^ 

EXITii 

.STARTi) 

$$H JOBSYM/ (777616)7616^ 
6! (7616)3616)^ 

BLT 6, 3777$X J 
JOBSYM! (777616)3616^ 

$$Z^ 

JOBSA/ (O)DDT (DDTEND)DDTJ 
^Cti 

.CORE 2^ 
.STARTiJ 

J OB REL/ 3777^ 
.SAVE DTAl DDT^ 



Load in 4K of core^ 



Enter DDT. 

Type out, in halfword mode (JOBSYM). 

Open register 6; put (JOBSYM)|^|_| into (6)l[-|; put 

(JOBSYM)rh-40008 into (6)rh. 

Perform block transfer through 3777g. 

Open JOBSYM; leave left half as is; change right 
half to 4OOO3 less than it was. 

Zero memory (except DDT). 

Open JOBSA. If left half ^ DDTEND, change it. 

Change back to symbol type-out mode. 

Return to Monitor level. 

Reduce core to 2K. 

Reenter DDT. 

Check JOBREL. 

Return to Monitor level . 

Save DDT on CUSP. 



Explanation - The DDT saved file must be saved in 2K (minimum amount of core needed for it). Also 
a starting address must be set up for DDT as location 140. To get DDT into 2K, the DDT symbol 
table must be moved down to the upper end of the first 2K of core. Any unused locations in DDT 
should be set to zero ($$Z) and JOBSYM should be set to the new location of the start of the DDT 
symbol table. Before saving the resulting file, a CORE 2 request should be given to the Monitor 
to ensure that DDT is saved as a 2K core image. 



In this example, the Loader ran in 4K of core. Even if the Loader is run in more than 4K of core, the 
same general principles apply. 
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EXEC DDT 



The Exec mode version of DDT assembles from the file DDT. MAC by using a parameter file from the 
Teletype as shown below. 

• R MACRO ^ 

*DTAn:EDDT,LPT: TTY:,DTAm:DDT) 
EDDT = 1 ^ 

END OF PASS ONE^ 
EDDT=0 

There are other versions of DDT that may be assembled. Please refer to the first page of the source 
file for explicit instructions. 



GLOB 



The three source files of the global cross-reference program (CROSSX, CROSS, and SCAN) 
are assembled separately by Macro and loaded as one file. The specific loading instructions are: 

• R LOADER^ 

*DTAn: CROSSX, CROSS, SCAN CALTMODE) tj 

LOADER^ 

EXIT^ 

^C^ 

• SAVE DTAm: GLOB 2^ 



AID 



There are three source files for AID: INTERP, ARITH, and KMON. Assemble these files 
parately and load as follows. 

• R LOADER^ 

• DTAn:KMON .ARITH .INTERP (ALTMODE) ,^ 
LOADER^ 

EXIT^ 

• SAVE DTAl AID 11^ 
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DESK 



The three source files of the Desk Calculator are: FOP, NUMBER, and DECS. Assemble 
these separately and load them as one file. The specific loading instructions are: 

.R LOADER^ 

*DTAn:FOP, NUMBER, DECS CALTMODE) ^ 
LOADER^ 

.SAVE DTAn: DESK n - 4 if macro capability is not desired; 

4 if it is desired. 
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